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How To Use This Manual 



INTRODUCTION 

This manual is the primary reference for the Fluke 1722A Instrument 
Controller. The 1722A System Guide is part of a manual set that 
supports the Controller, and covers hardware and software. 

The purpose of the System Guide is to provide an easy to use source of 
information for a variety of users. Whether this is your first exposure 
to programmable instrumentation, or whether you already have 
extensive programming experience, our intention has been to 
anticipate and meet your needs for accurate, well organized 
information. 

First-time users should read the Getting Started manual. Getting 
Started is designed to help set up the Controller and begin using it. The 
Fluke BASIC Programming Manual and other language manuals 
describe how to use a programming language and its available software 
tools. 
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Describes the organization of the System Guide, and the conventions 
used in the manual. 



Section 2 Setting up the Controller 

Provides a first look at the Controller, and contains unpacking and set- 
up information. It illustrates controls, indicators, and connectors, and 
includes start-up procedures. 







Section 9 Appendices 

Contains useful reference material, including a list of options and 
accessories and a glossary of terms. 

The material in this manual is organized in categories of tasks, in the 
order that most persons would perform those tasks. If more 






If you are evaluating the 1 722 A Instrument Controller for a particular 
application, the section titled Setting Up the Controller describes the 
general capabilities and functions of the unit. You might also read the 
introductions to each of the other tab-divided sections to assess the 
software packages and hardware configuration. The Specifications are 
given in Appendix A. 




For those with little or no experience in designing a programmable 
instrumentation system, Getting Started is the recommended place to 
begin. This handy stand-alone volume with its accompanying disk will 
familiarize you with the basic operations and layout of the Controller. 
Then you can use the System Guide as a reference for a variety of 
topics, or branch off to one of the language manuals (BASIC, Pascal, 
etc.) If you need more familiarity with the IEEE-488 bus, see Section 5, 
Communications, or Appendix C, IEEE-488 Interface References. 
More information is available in Fluke Application Bulletin AB-36, 
IEEE Standard 488 Digital Interface for Programmable 
Instrumentation, and Fluke Technical Bulletin C0076, 
Troubleshooting Information for IEEE-488 Systems. 



rogrammers 

If you already have some experience in programming, the sections on 
Software Configuration or Automating System Functions are a good 
place to start. Section 4, Devices and Files, can help you become 
familiar with the file conventions used in the 1722A. You may also wish 
to refer to the Communications section for information about the 
IEEE-488 bus and the RS-232 port. 



Operators 

An Operator’s Guide has been included after the appendices in this 
manual. The Guide shows the location and operation of all controls, 
care of the floppy disk, routine maintenance procedures, and what to 
do if things don’t go as expected. Additional copies can be ordered 
using Fluke Part Number 718163. 



A syntax diagram is a graphical representation of how to construct a 
valid command or statement in a programming language. It is a kind of 
“shorthand” way of writing down all the rules for using the elements of 
a language. Since they are used throughout this manual, learning how 
to read them can be a great time saver. 

Words inside ovals must be entered exactly as they are 
shown. 

Words inside boxes with rounded corners indicate a 
single key must be pressed, such as RETURN or ESC. 

This indicates a space in the statement. (Press the 
spacebar.) 



WORD ') 




To create a control character, hold down the control key 
(CTRL), then press the other key. This one is a Control C; 
it causes a break in the program. 



filename 



A box with lower-case words inside means 
supply some information. In this case, you would 
filename. 



(explanation) Words in parentheses are explanations of some kind. 

They give added information about the nearest block or 
path. 







From the left, any path that goes in the direction of the arrows is a 
legitimate sequence for the parts of a statement. This sample shows the 
correct syntax for naming a file. The translation is given below. 




□ A line exits the top of this diagram with no keyboard input. This 
indicates that it is possible to not specify the filename or its 
extension. In this case, the file would have “no name”, and the 
system would assign a “default extension”. 

□ Further down the diagram, you can see that there are other 
possibilities. They are explained by the remarks, “maximum of 6 
characters” for the name, and “maximum of 3 characters” for the 
extension. 

o The filename can be any combination of letters, digits, the $ sign, 
and spaces (up to six characters), and the extension can be up to 
three of those characters. 

□ The filename and extension must be separated by a period, as 
shown in the oval block at the top center. 

□ The remark “no extension” means that it is not necessary to specify 
an extension, even though a file name is given. Notice however, 
that this remark occurs after the period, so the period is necessary if 
a name is specified. 

□ Here are some examples of valid filenames according to the syntax 
illustrated in the diagram; 



TEST1N.$3A 1722A.RAC $$$$$$.$$$ 




The conventions listed here are used for illustrating keyboard entries 
and to differentiate them from surrounding text. The braces, {} ; 
brackets, [ ]; and angle brackets, < > ; are not part of the keystroke 
sequence, but are used to separate parts of the sequence. Do not type 
these symbols. 

<xxx> Means “press the xxx key”. 

Example: (RETURN) indicates the RETURN key. 



<xxx> /y Means “hold down key xxx and then press y”. 

Example: <CTRL)/C means to hold down the key 
labeled CTRL and then press the key labeled C. 



[xxx] Indicates an optional input. 

Example: [input filename] means to type the name of the 
input filename if desired. If not, no entry is required, and a 
default name will be used. 



xxx Means to type the name of the input as shown. 

Example: BASIC means to type the program name 
BASIC as shown. 



{xxx} Indicates a required user-defined input. 

Example: {device} means to type a device name of your 
choice, as in MFO: for floppy disk drive 0. 

(xxx) This construction has two uses: 

1. As a separate word, (xxx) means that xxx is printed 
by the program. Example: (date) means that the 
program prints today’s date at this point. 



2. Attached to a procedure or function name, (xxx) 
means that xxx is a required input of your choice; the 
parentheses are a required part of the input. Example: 
TIME(parameter) means that a procedure 
specification is the literal name TIME followed by a 
parameter that must be enclosed in parentheses. 
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The Fluke I722A is a programmable Instrument Controller designed 
to manage a multiple instrument system using the IEEE-488-1980 
instrumentation bus. It is able to command and communicate with 
various devices over this industry-standard bus. 




A 1 6“bit single-board microcomputer with 136K bytes of on-board 
memory. Approximately half is available for storing user 
programs. 

Programmable graphics; 640 x 224 pixel resolution. 



Video character enhancements that include 





and reverse video. 






Rackmountable. 



Extensive set of options for upgrading system capabilities as user 
needs increase. Memory can be increased to approximately 2.7M 
bytes; up to seven serial ports or six parallel ports can be added. 




Setting Up The Controller 
Physical Layout 





PUSHBUTTON 




Options 1,3, 4, 5, 6 

Memory Expansion Options 1,3, 4, 5, 6 

Input/Output Options 1,3,5 



[ 
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The 1722A is carefully packed for shipping to ensure that it arrives in 
good condition. Unpack all the containers and check the packing 
materials for accessories, cables, and manuals. Do not dispose of the 
packing materials before inspecting for shipping damage. If this 
inspection reveals damage or indicates that damage might have 
occured, notify the shipping agent immediately. Then call a Fluke 




Any microprocessor-based piece of equipment is made up of two parts: 
hardware and software. Installation usually involves a physical 
installation and some sort of software configuration. This section 
describes the physical installation of the 1722A Instrument Controller. 
Software configuration is covered in Section 3. 

Before using this section to install and checkout the Instrument 
Controller, be sure you are familiar with the location of all the 
connectors and controls. Doing so will assist you in setting up the 
instrumentation system. 



It is important to ensure that the location meets the environmental 
requirements listed in the Specifications. Heat and humidity are two of 
the worst enemies of electronic equipment, particulary the floppy disk 
and its drive. Allow at least 10 cm (4 inches) between the back of the 
unit and the wall to allow the fan to cool the unit adequately. 



Floppy disks are more sensitive to storage environments than the 
Instrument Controller. If a disk becomes colder than 10°C (50° F), or 
warmer than 50°C (122° F), allow it to reach room temperature and 
humidity before placing it in the Controller. The Check-Out 
Instructions include other disk handling precautions. 




Setting Up The Controller 
Installation 



Pre-Installation Checkout 

1. Place the 1722A on a suitable table. Check the label on the rear 
panel to ensure that the unit is set up for the proper line voltage, 
and that the proper fuse is in place. If either of them are incorrect, 
notify your Fluke Technical Service Center. 

2. Check to see that any ordered options are instaEed. If “installed” 
was specified on your order, the options should already be in the 
Controller. Otherwise they will be packed separately. 

3. Install any options that were not specified to be factory-installed. 
(Refer to the manual provided with the option.) 

4. Release the door latch on the floppy disk drive by pressing in on the 
top. Remove the protective shipping insert from the disk drive. 



CAUTION 

Do not attempt to operate the Controller before removing 
the protective shipping insert. Doing so can damage the disk 
drive. 



5. Attach the keyboard and line cord. 

Plug in the line cord and turn on 
the power switch (rear panel). 

6. Following the disk handling precautions on the next page, gently 
insert the System disk (label up) into the disk drive. 

NOTE 

Floppy disks supplied by Fluke use reinforced center rings 
to help seat the disk on the spindle. If floppy disks without 
such rings are used, first insert the disk, and gently close the 
door without latching it. Reopen the door slightly, then 
close and latch it. This insures that the disk seats on the 
spindle, and improves the reliability of reading and 
recording data. 
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Setting Up The Controller 
Power Up 

/ 



8. Press RESTART and watch the display. It should read: 




9. Following this display, the I722A performs a self-test that 
checks out the internal circuitry. The display changes to read: 




10. If the self test is not successful, an error message is displayed on 
the screen. If this happens, recheck the previous steps. For 
continuing failure, see the list of Self Test error messages in 
section 3. If everything seems to be in order, service may be 
required. Contact your Fluke Service Center. 
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li. After the self-test is successfully completed, the 1722A loads the 
Operating System software into main memory from the System 
disk. The display again changes to read; 




12. When the Operating System has been loaded from the floppy disk 
into memory, the system asks for the correct time and date to be 
set. When this has been done, the prompt for the Fluke Disk 
Operating System is displayed: 




13. If all these steps have been successful, the 1722A Instrument 
Controller is fully functional, and the Pre-Installation Checkout is 
complete. There is a more complete discription of the system’s 
power up activities in the next section, Software Configuration. 

NOTE 

Altered system software may not ask for the time and date, 
nor show the FDOS> prompt. The programmer can tell the 
installer how the successfully loaded software will appear. 






Because of the versatility of the 1 722 A instrument Controller, it is not 
possible to give more than general guidelines on how to configure it 
into a system. The drawing on the next page can help give a feel for the 
possibilities. Please consult the Configuration Table in appendix B for 
details. 




The Single Board Computer module in the 1722A has a set of switches 
which determine the default system configuration on power up. These 
switches define the baud rate of the RS-232 port, the IEEE-488 device 
address, and whether the 1 722A is to be designated “system controller” 
or an “idle controller” in a multiple controller system. The drawing 
below illustrates the switch settings as configured at the factory. If you 
need to alter the switch settings, consult the information in Section 9, 
Installing Hardware Options, for instructions on removing the Single 
Board Computer. Refer to Section 5, Communications, for complete 
information on RS-232 communications and multiple controller 
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System Installation 
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System Installation 




Like any system instrument, the 1722A can either be rack-mounted or 
used on a bench. Rack mounting is preferred for more permanent 
installations, or in those cases when the system will be set up in an 
assembly-line application. Research and development facilities, 
scientific or engineering laboratories, or in those places where the 
Controller will be used in various locations, generally either do not 
rack-mount the system, or else mount it into a moveable rack. 



Wherever the installation site is, try to choose a location where the 
display will not be subject to glare from overhead lights or windows. 



Workbench Installation 

N ormally, little thought is given to planning how to set up a test fixture 
on a work bench; wherever things fit is usually where they are put. 
However, a little planning can make the installation much more 
versatile, efficient, and pleasant to work with. 



1. Find a location for the Controller where the Touch Sensitive 
Display will be as close to eye level as possible. This will avoid 
long reaches for the operator that can become tiring, and 
ensures that a parallax error will not cause the operator to 
touch the screen at the wrong location. 
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Setting Up The Controller 
System Installation 



2. Position the keyboard so that the programmer is able to sit 
directly in front of the screen, rather than off to one side. 




3. If repeated connecting and disconecting of instruments is going 
to be done, make sure the back of the workbench is open and 
not against a wail. This makes connectors on the rear panel 
more easily accessible. 

4. Arrange other instruments on the bench so they are easy to see 
and operate. 

5. To protect information on the floppy disks, never place an 
oscilloscope, soldering iron, or other source of high voltage or 
electromagentic fields near the disk or disk drives. 

6. Keep the equipment cables neatly organized. Dressing the 
cables ensures that long cables will not degrade signal quality 
among the instruments, keeps the work area neat, and helps 
trace any problems that might occur. 
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Setting Up The Controller 
System Installation 



Rack Mounting 

Installing the Controller in an equipment rack requires more planning 
than a bench top installation because it is more difficult to change if 
things don’t work out. Here are a few things to keep in mind as you 
plan a rack-mounted installation: 

1. Plan for a way that the keyboard can be easily used after the 
installation. Even though the keyboard will not be attached 
during normal operation, the keyboard may be needed later to 
change programs. If the Controller can be left in the rack, time 
and effort can be saved. 

2. If the programs will have a high degree of interaction between 
the operator and the Touch Sensitive Display, consider 
mounting the Controller so that it will be at eye level from the 
operator’s normal working position. If the operator stands, the 
Controller should be mounted about 1.5 meters (5 feet) from 
the floor. If the operator sits, then it can be mounted lower. 
This will avoid long reaches and parallax errors. 

3. If programs will not require much interaction, place the 
instrument with which the operator will be working most 
frequently directly at eye level, and fill the rack outward from 
there with those instruments used less frequently. 

4. To protect the information on the floppy disks, position any 
instruments that radiate electromagnetic fields as far as 
practicable from the Controller. 

5. Observe good cable dress to ensure good signal quality and to 
help trace any problems that might occur. 
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Setting Up The Controller 
System Installation 



Connecting the IEEE-488 Bus 

One of the features of the IEEE-488 connector is that it is both a male 
and female connector. Because of this, it is possible to stack all of the 
connections (up to the maximum of 14) into one location, orto arrange 
them in any other configuration desired. However, it is probably a 
better idea to distribute the IEEE-488 connectors among the 
instruments for two reasons: 

1. In such an arrangement, the connectors do not extend as far, 
and connector stress that could cause intermittent problems 
later is eliminated. 



2. Using a distributed connector pattern, it is easier to change any 
connector’s position than if the bus connections were all at the 
same place. 

The IEEE-488 standard states that total cable length in a system should 
not exceed 20 meters (about 60 feet), and that no single cable should 
exceed four meters (12 feet). Allow 2 meters (6 feet) of cable per piece of 
equipment. 

Cables 

When it is shipped from the factory, the 1722A Instrument Controller 
meets or exceeds the Class B requirements of FCC part I5-J and VDE 
0871. To ensure continued compliance with these standards, any cables 
connected must be shielded and incorporate 360° metal connector 
bodies. These are available from John Fluke Mfg. Co Inc. using these 
model numbers: 

IEEE-488 

1 meter: Y8021 

2 meter: Y8022 
4 meter: Y8023 

RS-232 

2 meter: Y1707 
10 meter: Y1708 

Also, if you intend to use the composite video output for connection to 
an external monitor, it is recommended that you use a cable assembly 
constructed of RG-58U coaxial cable with the cable shield properly 
terminated at the connectors. This is necessary in order to maintain 
compliance with the FCC and VDE regulations for radiated emissions. 
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System InstaMation 



BRINGING THE SYSTEM UP 

This section can be used in two ways. First, it can help you plan for the 
eventual test configuration by providing some ideas about how to test 
the system as it is built. Secondly, it provides some guidelines on 
actually bringing the system up once it is designed. 

Below is a representation of a “typical” instrumentation system. In the 
guidelines that follow, this system is used as a sample of how to ensure 
success in bringing the system up. 




UNIT UNDER TEST 



This system has 5 devices connected: 

1722A Instrument Controller 
6070A/6071A Frequency Synthesizer 
1953A Digital Frequency Counter 
1776A Serial Printer 
Unit Under Test 

All the devices except the Unit Under Test and the Serial Printer are 
connected to the IEEE-488 bus. The printer connects to the RS-232 
port, and the Unit Under Test connects to the measurement 
instruments. 





In this example, a short software test routine should be written that 
programs the synthesizer’s output frequency and then listens to the 
frequency counter to see that it has measured the same value that was 
programmed into the synthesizer. The last step in the test program 
would be to send the results to the serial printer for a hard copy. 

This same example system is used in Section 7, Automating System 
Functions, to explain in detail how this test program would be 
developed. 

1. Set up the IEEE-488 bus addresses of each device on the bus. 
This is usually done by installing or removing jumpers or by a 
switch setting. The exact procedure depends on the instrument. 

2. Connect the IEEE-488 instruments. One cable is required for 
each instrument. 

3. Connect the frequency counter to the synthesizer. 

4. Power up the system, and run the test program. If it is 
succesful, the test validates the bus. Also, the software that was 
written for the test is a development tool for the actual system 
that will result. It will have verified that the correct addresses 
are programmed into the IEEE-488 instruments, and that the 
programmer is able to talk and listen to each of the 
instruments. 

5. Turn the system off and connect the RS-232 printer. Then 
power up the system and run a second test routine that sends 
the data to the printer. This data may be the result of the test, or 
it might simply be a short data file that includes a full character 
set of the printer. 

6. Power down again, and connect a known good unit as the Unit 
Under Test. Run the second test routine, and see that the 
correct readings result. 

If all of these tests are successful, the instrumentation system is fully 
functional. The value of setting up this kind of minimal system before a 
more comprehensive one is that it verifies both hardware and software, 
and provides a building block approach to the final configuration. 




Setting Up The Controller 



CONCLUSION 

In this section, the emphasis has been on physically setting up the 
Controller. However, the instrumentation system cannot be set up 
until the system software is configured, and the test programs are 
written that verify the hardware installation. 

In the next section, the next step in setting up the Controller, 
configuring the software, is discussed. Section 6, Creating and Editing 
Programs; and Section 7, Automating System Functions describe how 
to program the Controller. 
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The last section discussed how to set up the Instrument Controller 
from a physical point of view. This section describes the software, 
which, together with the hardware, make up a functional Instrument 
Controller. The section includes a description of the software that is 
shipped with each new Controller. The topics in this section are: 

Loading the System Software 
The Startup Command File 
Setting the Time 
The Operating System 
The Command Line Interpreter 
Utility Programs 
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LOADING THE 



SYSTEM SOFTWAR 



When the Controller is powered up, a small program that is 
permanently recorded in a memory has control of the internal 
microprocessor. This program, the Bootstrap Loader, first says 
“HELLO”, then performs two very important functions: 

o It checks out the Controller with a self test to make sure all the 
hardware is operating properly. 

o It loads the system software. 

The Self test checks the memory, processor, and the interfaces. 




The benefit of this automatic test at power up is that if it is successful, 
the Controller’s hardware is verified as operational and if a problem 
occurs later, the hardware can be eliminated as the fault. If the test 
fails, press RESTART and try again. If the problem persists, contact 

your Fluke Customer Service Center, 
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Self-Test Error Messages 

If an error occurs during the self test, a message will be displayed that 
takes the form: 

FAILED! - XXX Test. 

The XXX will be replaced by the failing component, and may be any of 
the following: 

- ROM Test 

- RS-232 Port Test 

- Memory Mapper Test 

- Macrostore Memory Test 

- On-board Memory Test 

- IEEE Controller Test 

- Floppy Disk Controller Test 

All of these messages indicate a non-recoverable hardware failure. Try 
resetting the Controller first, but if the error continues, make a note of 
the test that failed, and contact your Fluke Service Representative. 

After the Self test, the Bootstrap loader attempts to load the operating 
system. 

The Bootstrap loader searches for the system software on the floppy 
disk, Electronic disk, then in the bubble memory if one is installed. If 
the system software is found, it is loaded into main memory. The device 
from which the system software was loaded is made the system device. 
(For more information about the system device, see Section 4, Devices 
and Files.) 

As soon as the operating system is loaded, it takes over from the 
Bootstrap Loader, and the instructions recorded on the software disk 
direct the controller’s activities from that point. 
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Other Errors 

Some errors can occur during the power-up self-test, or anytime during 
the operation of the Controller. They are always preceded by a 
question mark indicating that they are “non-recoverable”; the 
Controller continues to return the same error unless you take some 
corrective action. These errors and the corrective action required are: 

Message Meaning 

?Disk Not Ready Insert or reinsert the System disk. 

Either there is no disk in the drive, or it 
has been inserted incorrectly. Make 
sure the disk drive door is latched. 

?IUegal Directory The disk is faulty and must be replaced 

before the Controller will operate 
properly. It may be possible to save the 
files from the bad disk by using the File 
Utiltiy program. 

? Oe V i ce Error The system is having difficulty reading 

the floppy disk. Check to be sure it is a 
System disk, and that it is inserted 
properly. If so, RESTART and try 
again. If the failure continues, try 
another System disk. 

?No System On Device The Controller does not recognize the 

disk in the drive as a System disk. Try 
another System disk. The wrong disk 
may be inserted or it may be inserted 
incorrectly. 



3-5 




Software Configuration 
Power Up 



The Startup Command File 

On a standard System disk, the operating system loads a special 
command file called STRTUP.CMD. A command file is a collection 
of keyboard commands that would otherwise have to be typed in. 
Command files serve to automate commonly performed functions. 
For more details, see section 4. 

The STRTUP.CMD file on a standard disk loads two more programs: 
The Time and Date Utility and the BASIC Interpreter program. 

The STRTUP.CMD file is easily changed. After gaining some 
familiarity with the Controller, you may want to modify the startup file 
to customize the Controller’s functions at power-up. There is a 
complete description of how to do that in Section 7, Automating 
System Functions. 

□ If the file STRTUP.CMD is found, it is loaded, and the FDOS 
prompt will not have been displayed. Instead, the display reads: 



f 










FDOS V#r»ion x.y 

Total Systea Uvaory - nnn Kbytta 

E-Disk - ft Kbytfs fpss - Rft Kbytes (nn bioeks> 


\ 






Startup Coaaand File Eseout ion in Progress 








Please Standby. . . 







o If the file STRTUP.CMD is not found, the Operating System takes 
control. This would happen if the disk being loaded is not the 
System Disk supplied with the Controller, or if the 
STRTUP.CMD file has been renamed or deleted. 

□ The STRTUP.CMD file on the System Disk supplied with the 
1722A first checks the Time and Date Utility to see if the time has 
been set. If it has, it loads the BASIC Interpreter program and 
transfers control to it. 
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Setting the Time 



Setting the Time 

□ If the time clock has not previously been set, the display will next 
read: 




□ Type in today’s date in numeric form, starting with the day, then 
the month, and then the year. The entries must be separated by a 
hyphen or other non-numeric character. Use the DELETE key to 
correct any mistakes. Press (RETURN) and the display reads: 




□ Enter the time in 24-hour format: first the hour, then the minutes. 
Separate the two by any non-numeric character. Press 
(RETURN) to complete the operation. 



The time on this clock is 8:20. 

If it is before noon, enter 08 20; 
if it is evening, enter 20 20. 
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o Once the date and time have been set, the BASIC Interpreter 
program is loaded. The display reads: 




□ The “Ready” prompt indicates that the BASIC Interpreter 
program is running in the Immediate Mode. 

If all these things have happened as described, the Controller is 
operating properly. The “Ready” prompt indicates that the Controller 
has passed the Self Test, that the STRTUP.CMD program has run 
properly, and that the Controller is now ready to receive commands in 
the BASIC language. 

If you do not want to begin by programming in BASIC, it is a simple 
matter to exit the BASIC Interpreter program, and begin working with 
the Command Line Interpreter. To do that, type EXIT 
(RETURN) . The prompt for the operating system is FDOS) 

To get back to BASIC, just enter the word BASIC, and then 
(RETURN) 

Below is a description of the software modules that make up the 
operating system on a new system software disk. 
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Because the Instrument Controller is a programmed instrument, its 
functions are controlled by a master operating program. In the 1722A, 
this program is the Fluke Disk Operating System (filename 
FDOS2.SYS). The program’s name is usually shortened to ‘FDOS’. 

FDOS controls the hardware components of the Controller. It takes 
instructions from the keyboard or from a program, and directs the 
functions of ports, manages the memory, and manipulates files to 
convert the instructions into action. 

FDOS is soft-loaded, which means that it is recorded on a disk, rather 
than being permanently in the memory. The advantage of making 
FDOS soft-loaded is that it can be easily maintained and updated. 
Also, new software can easily be added without having to install special 
hardware. FDOS is loaded into memory whenever the the instrument 
is turned on. 



For this reason, a floppy disk containing the Operating System file 
(FDOS2.SYS) must be in place when the power is turned on or when 
the RESTART button on the front panel is pressed. This file alone is 
not sufficient for proper operation, however. Another file, 
MACRO.SYS, which is also supplied on the 1722A System Disk must 
be included on any disk which is to be used to start up the Controller. 
This file contains machine language subroutines used by the system 
software and other programs. 



One more file on the System Disk, ALIAS. SYS, is also loaded into 
memory when the Controller is booted up. This file is not required for 
proper operation of the Controller, but it contains abbreviations for 
commonly used commands that can save time during programming. 
The alias file is explained in more detail in Section 7. 

Since it is possible to relocate the Operating System into Electronic 
Disk or an optional Bubble Memory, and since the Bootstrap loader 
looks at these devices when it cannot locate FDOS on the floppy disk, 
it is not necessary to have the System Disk physically in place to load 
the Operating System. In fact, the loading process can be considerably 
speeded up by recording the Operating System into memory, and 
loading from there rather than from the floppy disk. 




Software Configuration 
The Operating System 



Command Line Interpreter 

The part of the operating system that receives instructions from the 
keyboard is called the Command Line Interpreter. The Commanc 
Line Interpreter can accept either single command lines (instructions) 
from the keyboard, or the instructions contained in a Command file. 
Instructions can be entered either in lower case or upper case. To 
distinguish commands from other text, this manual shows only upper 
case. 

Automating the I722A using Command Files is described in detail in 
Section 7, Automating System Functions. 

Other Software on the System Disk 

The following programs are provided to assist you in configuring the 
Controller and in developing software: 

TIME The Time and Date Utility, [filename TIME.FD2\ 

This utility program is used to set or read the time and 
date maintained by the I722A calendar/ clock circuitry. 
Once the clock is set to the correct time and date, it can be 
used to imprint programs or data. It can also be used to 
display the current setting. Battery power keeps it 
accurate when the power is turned off. The Time and Date 
Utility program is discussed in more detail in Section 7, 
Automating System Functions. 

SET The Set Utility, [filename SETFD2] 

This program changes the parameters at the RS-232 port. 
These parameters govern the way information is sent and 
received between the Controller and any devices 
connected to the serial communications port. One 
parameter, the length of time out, can also be changed for 
the IEEE-488 port. The Set Utility program is discussed 
in more detail in Section 5, Communications. 

FUP The File Utility Program, [filename FUP.FD2] 

The File Utility is used to to create, delete, rename and 
copy files, and to channel them between the various 
devices in the Controller. The File Utility program is 
described at the end of the next section, Devices and Files. 
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The Operating System 



EDIT 



BASIC 



SYSGEN 



COMPAT 



CONFIG 



OTP 



TCOPY 



The Editor program [filename EDIT.FD2] A program 
for creating and editing other programs, the Editor lets 
you insert, delete, search for, and replace characters, 
lines, phrases, and strings in your files. See Section 6 for 
details. 

This is the program that permits the Controller to run 

BASIC language programs. The Fluke BASIC 
Programming Manual set that is supplied with the 
Controller is a complete reference for the BASIC 
language. 



The System Generation program, [filename 
SYSGEN.FD2~\ 

This program is used to create operating system software 
to support configurations that include options. 

The Compatibility Test program, [filename 
COMPAT.FD2] 

This program prints the names, version stamps, and other 
data about an executable program file. A complete 
description of the Compatibility program is included at 
the end of this section. 

The Configuration Data program, [filename 
CONF1G.FD2} 

This program prints a list of the device names which the 
currently executing Operating System is configured to 
use. The program is described in detail at the end of this 
section. 

The Object Translator Program, [filename OTP.FD2'] 
OTP converts object files created by the FORTRAN 
Compiler and the Assembler into a simpler format usable 
with the BASIC interpreter’s LINK, statement. This 
program is used with the Assembly Language option 
(17XXA-20I) and the FORTRAN option (17XXA-202) 

The Touch“Copy program [filename TCOPY. FD21 A 
program that uses the Touch-Sensitive Display for listing 
and copying files or groups of files. TCOPY has a menu 
mode and a command mode to serve a variety of 
applications. See Section 4 for a description of all the 
TCOPY options. 




The System Generation program is provided on the System Disk with 
the filename SYSGEiN.FD2. It is a tool for making a new Operating 
System. In addition to the standard software device drivers, the file 
FDOS2.SYS that is supplied on the System Disk contains software 
device drivers for the following optional modules for the 1722A: 




If you do not have any of the above optional devices, you may wish to 
create a new configuration of FDOS2.SYS using the System 
Generation program. Doing so will free up the memory used by the 
additional drivers and make it available for programs or Electronic 

Disk. 

Device drivers are also available for the following 1722A peripherals: 



If you have any of these peripherals, you must use the System 
Generation program to reconfigure the operating system to include 
these drivers before using them with the 1722A. 



The CONFIG program described later in this section can be used to 
determine the configuration of the Operating System currently in 
memory. 




The System programs are software modules supplied with the 
Controller as files on the System Disk. These machine-language 
programs are interdependent and are compatible in the combinations 
supplied with the Controller. 

System programs are easily copied and erased, since they are treated as 
any other file. The portability and copying ease of system software 
allows you to take advantage of Fluke’s continuing program of 
software development. However, it is possible to inadvertently record 
incompatible modules onto the same disk. Therefore, it is important to 
keep track of the various software modules on your disks. The 
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Use caution when copying new or updated software to make sure that 
the modules are recorded in the same combinations as the original 
disk. If a mistake is made, the operating system may not load the 
incompatible module, and display an error message. 



Experienced programmers often suggest keeping a record of any 
changes made to software disks, to keep mistakes to a minimum and to 
make it easier to track down any problems that might occur. One way 
to do this is to use the /L option of the File Utility program to print a 
listing and keep it with the floppy disk. 




The System Generation program requires some files in order to build 
the operating system. Before beginning, use the File Utility Program to 
make sure you have these files available on your system device: 



SYSGEN.FD2 (the program that generates the new FDOS) 
FDOS2 .LIB (library of modules to build FDOS) 

FDOS2 .CFG (used by SYSGEN to generate the prompts) 

Also, decide if you want to keep a copy of the original Operating 
System configuration. If so, make a backup copy of the old version of 
FDOS2.SYS before running SYSGEN. This can be done by renaming 
the file using the File Utility Program (refer to Section 4, Devices and 
Files). 

1. From the FDOS) prompt, type SYSGEN (RETURN). 

2. When the program has loaded, the screen will display the 
System Generation Utility program identification, then will list 
the names of files it is linking to, and then begin asking if you 
want various drivers. 

3. Answer Y to those that are desired, otherwise N. Only include 
drivers for the devices you will be using. 
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4. After you answer all the questions, the program reads the 
required software modules from the file named FDOS2.LIB, 
and links them together to create the new operating system. 

5. Press RESTART, and allow the new Operating System to 
load. Test each module by using the File Utility Program to 
scan (/ S), format (/ F), or zero (/ Z) the devices associated with 
each driver. Or you may run the diagnostic program for the 
desired module (refer to Appendix G, System Diagnostic 
Software). 



If the file that SYSGEN is writing (FDOS2.SYS is the default) is file 
protected, the error message ?File protected is displayed and SYSGEN 
exits. 



If you want SYSGEN to place the new FDOS on a device other than 
the system device, at step 1 enter “SYSGEN dvc:” where dvc is the 
name of the device. For example, if MFO: is the system device, but you 
want SYSGEN to put the new FDOS2.SYS file on EDO:, enter 
SYSGEN EDO: (RETURN) from the FDOS) prompt. 



If you want the output of SYSGEN to be named differently than 
“FDOS2.SYS”, then enter “SYSGEN filename” from the FDOS) 
prompt. For example, to name the output of SYSGEN 
“FDOS2.NEW”, enter “SYSGEN FDOS2.NEW(RETURN)”. Only 
an operating system with the name FDOS2.SYS can be booted and 
executed on the controller. FUP can be used to rename the file 
FDOS2.SYS. 
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THE FDOS CONFIGURATION DATA PROGRAM 

The FDOS Configuration Data program is a utility program supplied 
on the System Disk with the file name CONFIG. FD2. It prints the 
version number of the Floppy Disk Operating System (FDOS) 
currently in use, and the device names of all peripheral devices which 
FDOS has been configured to use. 

Section 4 of this manual explains the the difference between serial and 
file-structured devices. 




From the FDOS) prompt, type CONFIG (RETURN >. The CONFIG 
program will print the current FDOS version and configuration as 
follows: 




NOTES 

1. If FDOS was configured with a Bubble Memory or a Dual 
Serial Interface driver, and neither of these devices are installed 
when the Controller is powered up, they will not appear on the 
above list. 

2. If E-Disk was not configured when CONFIG run the 
device name will not appear in the above list. 

3. There are no device names for ports on the Parallel 
Interface Board (1 7XXA-002), therefore it also willnot appear 
in the above list. 

Notice that the entry for the floppy disk, MFO:, also contains the name 
SYO:. This indicates that the “default system device” (SYO:) is currently 
assigned to device MFO:. 
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Data to a File 



The CONFIG program can write its data to a file instead of the screen. 
From the FDOS> prompt simply place a “>” character followed by a 
legal file name into which the output from CONFIG should be placed: 



FDOS >CQNFI© 
FDOS > 



>CQNFIO. DAT 



In this case, the configuration data will be written to the file 
“CONFIG.DAT” on the current “system device”, named “SYO:”. Any 
legal FDOS file name may be used. 



CONFIG 





nformation 



The CONFIG program prints a short help message in response to an 
invalid command. A longer help message is printed in response to an 
explicit request. 



An invalid command causes a one-line “usage” message to be printed. 
This is simply a quick reminder of how the CONFIG program expects 
to be told to do its job. For example; 




In this case CONFIG simply prints an example command line. The 
square brackets surrounding the command line options simply 
indicate that they may be omitted if desired. 
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A slightly more involved help message is produced by the question- 
mark command to CONFIG: 



FD08> cenfig ? 

Th* "Conflg" Brogr«n print* the device* uhich nag be u*sd ulth the verelan 
of FD08 eieeuTing on your neehlne. The FQOS vertion nunbar appear* on the 
Plrst line. A bianli line fonou*. Succeeding line* contain a device name 



ling 

starting in the first column, a tab character, and the utord 
“File-structured" to indicate the device type. 



Buriat" or 
For eiiample. the command: 



FDOS > config 

ulll print the FDOS configuration to tha 17S2A display. 
FDOS> config Imyfila.cfg 

util print the configuration data to the fils "myftlc.c 
FDDS) 



The command: 



The version number of the CONFIG program itself may be printed by 
using the command: 




FDOa >CONFIO -VERSION 
CONFIG Version m. n 
FD09> 



The letters “m.n” will be replaced by the actual 2-digit version number 
of the CONFIG program. 
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THE COMPATIBILITY TEST PROGRAM 

The Compatibility Test Program is a utility program supplied on the 
System Disk with the file name COMPAT.FD2. It is a tool which 
allows the version stamp of executable program files to be printed and 
optionally checked for compatibility with any version of the Floppy 
Disk Operating System (FDOS). 

Executable programs (all files with extensions .SYS or .FD2) contain a 
version stamp field when they are stored. This field records the version 
of FDOS under which the file was created. The version stamp is not 
necessarily the version number which is displayed when the program is 
run. For example, a copy of the File Utility Program, called FUP.FD2, 
has a version stamp of 1 .0 if it is meant to be executed with version 1 .0 
FDOS. 



Running the Compatibility Program 

From the FDOS) prompt, type COMPAT (RETURN). The 
COMPAT program will (by default) print the version numbers of all 
executable programs found on the current System Device (device 
SYO:). For example: 




Notice that in this case the System Device (SYO:) was the floppy disk 
MFO:. 
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Program Help Information 

COMPAT will provide both long and short “help” messages. A short 
“usage” message is produced in response to a command with invalid 
syntax. This message is: 




This message is a short reminder about the correct usage of 
COMPATs commands. 

A longer help message is printed in response to the “?” command: 




COMPAT can give more information than just the version number 
about the files selected for printing. The command to do this is 
+DATA. 
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The information printed by the +DATA command is simply the 
information which FDOS uses to load a machine language program 
into memory. The File name and Version fields have already been 
discussed. The other information fields are: 

Load is the first (lowest) memory address to be used when loading 
the program into memory. 

Entry is the memory address at which the program initialization 
code begins. FDOS transfers control to this location to start 
the program’s execution. 

Size is the number of bytes which the program requires to hold 
both instructions and any initialized data. More memory 
than this may actually be required to execute the program. 
For overlaid programs this number is the “longest overlay 
path”, or the maximum memory used by any sequence of 
overlays. 

Overlay is “Yes” if the program uses overlays, otherwise “No”. 

Space is “Kernel” if the program must be loaded into the lowest 
64K bytes of memory (which is where FDOS is loaded), or 
“User” if the programs may be loaded into any memory 
region other than the lowest 64K bytes. 

Mode is either “User” or “Privileged”. This indicates whether the 
program executes in User mode, which prevents the use of 
certain critical machine instructions, or in Privileged mode, 
which permits the program to address any memory location 
and to execute any machine instruction. 
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Directing Output to a File 

The output of COMPAT may be written to a file instead of to the 
display simply by using a “ )” character followed by the name of the file 
to be created. For example: 



FDQS) CDMPAT >CdRPAT. DAT 
PDOS) 



In this case the output of COMPAT would be written to the file 
COMPAT.DAT. 



USING OTP 

OTP (the Object Translator Program) converts object files created by 
the FORTRAN Compiler (Option I7XXA-202) or the Assembler 
(17XXA-20I) into a simpler format that can be used with the BASIC 
Interpreter’s LINK statement. 

1. Compile any FORTRAN subroutines by using the 
FORTRAN Compiler (FC.FD2). If any FORTRAN 
subroutines are used you use OTP in step 4. 

2. Use the 'Assembler (ASM.FD2) to assemble any Assembly 
Language subroutines. If any of the Assembly subroutines use 
DSEG (Data SEGment) or CSEG (Common SEGment) 
directives you use OTP in step 4. 

3. Use the Linkage Editor program (LE.FD2) to do a PARTIAL 
link of the object files created in steps 1 and 2 with the 
Parameter Linkage Routine object file FSRGMY.OBJ. 

4. This step is optional, but see steps 1 and 2. Run the object file 
created by step 3 through OTP to create an object file which 
may be used by the BASIC Interpreter’s LINK statement. 

5. Use the LINK statement in the BASIC Interpreter to load the 
object file created in step 4 with an executing BASIC program. 
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This section has described the programs that are recorded on the 
System disk supplied with the 1 722A. These programs are tools for the 
system designer to use in setting up an instrumentation system. None 
of these programs actually control an instrumentation system, but 
facilitate writing those programs that do. 

To make use of these programs requires using some other tools, 
referred to as the system’s resources: devices and files. 

The next section introduces these system resources, and explains how 
to use each device and each type of file. 
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In the last section, the Instrument Controller was described as a 
machine having two components; hardware and software. Together 
they operate as an Instrument Controller. Both the software operating 
instructions and the hardware are necessary parts of a working System 
Controller, This section expands that view, and introduces a third 
aspect of the Controller: the resources with which it will perform its 
ultimate task of controlling an instrumentation system. 

The resources of the Controller are its devices and files. A device can be 
thought of as a storage location, like a file cabinet. Electronic files are 
stored in the Controller’s devices just as hardcopy files are stored in file 
cabinets. Devices and files are discussed together here because they are 
so closely related. This section describes how to use the File Utility 
program to manipulate devices and files. Section 7, Automating 
System Functions, explains how to manipulate them under program 
control. 




Devices and Files 
Introduction 



Devices 

Some terminology about device names is specific to the Controller. 
The term “device” is used in several different ways; understanding the 
distinctions is essential to effective programming. 

Every IEEE-488 instrument is called a device, and the Controller sends 
information out to a device address when it sends program data to the 
instrument, or sends a command to the instrument to take a 
measurement or to send back measurement data. 

Besides that kind of device, the 1 722 A has a number of internal devices. 
In this context, a device is a hardware resource that can act as a source 
or destination of data. There are two types of these Controller-specific 
devices. One type is called “file-structured”, and can be thought of as a 
location to store programs or data. These devices include the floppy 
disk, Bubble memory, and E-Disk. In general, it can be said that only 
this type of device can be assigned the function of “system device” (the 
one the Controller assumes you mean if you do not specify a device). 

The other kind of internal device is usually called “serial” to distinguish 
it as a pipeline for information, rather than as a location of 
information. Notice that the term “serial” has a slightly different 
meaning than usual when it refers to a device, it may be that a serial 
device sends serial data, but not necessarily. For example, the RS-232 
port is a serial device, and is used to send serial data; the IEEE-488 port 
is also a serial device, but the data is sent bit parallel, byte serial. 

On power up, a cold start, the bootstrap PROM checks the floppy disk 
drive for the operating system program (FDOS). If it is not there, it 
checks the other file-structured devices, first the Electronic Disk, and 
then bubble memory. If there is no system software, an error message 
indicates that there is “no system on device”. 

When the RESTART button is pressed, the system performs a warm 
start. A warm start differs from a cold start in that the memory is not 
cleared nor is the self test performed; only the Operating System is 
loaded. If there are any files stored in the Electronic disk, they remain 
intact. 
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Introduction 



The table below defines each of the Controller’s devices. Notice that all 
device names must have two alphabetic characters, followed by a 
number, and ended with a colon. The colon must always be included 
because it is part of the name. 



DEVICE NAME 


SYSTEM RESOURCE 


TYPE 


Standard System 




KBO; 


Keyboard (Input) 
Display (Output) 


Serial 


KB1: 


RS-232 Port 


Serial 


GPO: 


IEEE-488 Port 


Serial 


MFO: 


Mini-Floppy Disk Drive 


File-structured 


EDO: 


Electronic Disk 


File-structured 


Optional Resources 




KB2; 


Optional RS-232 Port 
(Option -008) 


Serial 


GP1: 


Optional IEEE-488 Port 
(Option -008) 


Serial 


SPO; - SP9: 


Optional Dual Serial Interface 
(Option -009) 


Serial 


MF1: - MF4: 


Optional Floppy Drives 


File-structured 


MBO: - MB3: 


Optional Bubble Memory 


File-structured 


WDO: - WD3; 


Optional Fixed Disk Drives 


File-structured 
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A file is an organized record of related information. The file type can 
usually be identified by its extension (the three characters following the 
file’s name, and separated from the filename by a period). The 1722A 
uses several types of files. 

System Level Files 



FILE TYPE 


EXTENSION 


DESCRIPTION* 


System 


SYS 


Reserved for 1722A System Operations 


Command 


CMD 


A collection of keyboard commands 


FDOS 


FD2 


Binary machine language 


Configuration 


CFG 


Used by SYSGEN to generate FDOS2 


Help 


HLP 


Data file for Help screens 


Place holder 


BAD 


Indicates bad areas during packing 


Source 


BAS 


Default extension 


Lexical 


BAL 


Results \A/hen a file is SAVELed 


Backup 


BAK 


Created by System editor program 


Source 


FTN 


FORTRAN 


Files 


Assembler Source ASM 


Output of ASMPP, Input to ASM 


Error File 


ERR 


Output of BC 


Library 


LIB 


Input to LE, LM, and LL 


General List 


1ST 


Output of ASM, FC 


Map File 


MAP 


Output of LL, LE 


Object 


OBJ 


Output of BC, FC, ASM; input to LE, LL. 1 


Preprocessor 


PRE 


Input to ASMPP 


Temporary 


TMP 


Temporary file for BC, FC and LE 



* Description abbreviations 

ASM = Assembler 

ASMPP = Assembler Pre-Processor 

BC = BASIC compiler 

FC = FORTRAN compiler 

LE = Linkage Editor 

LL = Linking Loader 

LM = Library Manager 
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All of the KB devices are serial. They are RS-232 ports, and provide an 
entry and exit point for serial communications between the Controller 
and other RS-232 compatible equipment. RS-232 is a designation for a 
standard digital communications interface, and describes the 
connector and voltage levels used in bit-serial communications. The 
standard permits many of the operating characteristics to be changed, 
to allow the connection of many types of equipment. Section 5, 
Communications, gives more information about the standard, and 
about how to change the Controller’s RS-232 port parameters. 



KBO: is both an entry and exit point for information between the 
Controller’s program and the outside world. As an input port, it is the 
Y1700 Keyboard. As an output, it is the display itself. KBO: is 
sometimes called “the Console Device”. None of the operating 
parameters of KBO: can be changed except the baud rate, but it should 
only be changed when using an external terminal. Otherwise, an error 
will result. 



KBl: is the built-in RS-232 port for connecting the I722A to other 
equipment that uses the standard interface. It is set to a standard 
configuration on power up, and it can be customized to different 
characteristics using the Set Utility program. See Section 5 for a 
detailed discussion of this utility program. KBl: does not exist unless 
the Video module is installed in the Controller. 



This device name is used for an optional RS-232 port, and is used if 
Option -008 (IEEE-488 / RS-232 Interface) is installed. It operates 
exactly like KBl:. 

SPO: - SP9: 

These are the device names for the ports on the Dual Serial Interface 
Option -009. The ports are treated similarly to the KBn: devices. Up to 
three modules can be installed, and each port can be configured for 
RS-232-C, RS-422, or 20 mA Current Loop electrical interfaces. 
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Devices 



Ports 



As shipped, the standard 1722A Instrument Controller has a single 
IEEe 488 port. The IEEE-488 port has the device name GPO: when 
used as a serial device (output only), and Port 0 when used by a 
program as an instrument port. 

One application for GPO: is to use an IEEE-488 compatible printer as a 
listing device. Rather than writing a “PRINT” program, information 
can be sent out simply by specifying GPO: as the destination device. 



The device name GPl: is used for the optional IEEE-488 port, and is 
only implemented if Option -008 (IEEE-488 / RS-232 Interface) is 
installed. Its purpose and operation are identical to GPO:. 



Floppy Disk Drives 



The integral 5-1/4” floppy disk drive provides the Controller with 
removable storage media (MF stands for mini-floppy). Using the 
floppy disk drive, a collection of programs can be built up, so that for 
each set of tests, a different floppy disk would be used. 

Floppy disks must be formatted prior to use. Formatting is the process 
of sectioning off the disk so that information written onto it is allocated 
to the proper location, and so that the Controller is able to locate it 
again after it is recorded. Floppy disks can be formatted either as 
single- or double-sided (see File Utility program for details). 

All floppy disk operations can be simplified by using File Utility 
commands in a Command file, and by using the Controller’s Alias file. 

The MFO: device is the default device at power up. It is possible to 
designate another device as the location of system software, however. 
See the discussion of the File Utility program’s Assign command. 



Four other disk devices can be connected to the Controller at the 
IEEE-488 connector. The Fluke model 1760 A is a single 5-1/4” unit, 
and the 1761A has two drives. In this usage, each device will act similar 
to MFO:. Operation over the IEEE-488 bus is transparent to the user. 
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Devices 



Electronic Disk 



The EDO: device designates the Electronic Disk (E-Disk). The 
programmer can designate portions of memory as “Electronic Disk”. 
Any area of memory not used by the Operating System can be 
designated as E-Disk. When E-Disk is used, it must first be configured, 
a process that allocates how much space is to be used for E-Disk, For 
details, see the File Utility program / C command later in this section. 

Because the E-Disk device is implemented in random access memory, 
it will perform any operation more than 100 times faster than if the 
floppy disk is used. However, the memory is volatile, so any programs 
or data stored in E-Disk are lost when the system is turned off. 




These are the device names for Bubble Memory Options -004 and -005, 
512 and 1024 blocks respectively. A block of memory is 512 bytes. 

Regardless of the capacity of the Bubble Memory module(s) installed, 
each module is a separate device, whose device designation is selected 
by a switch setting on the board. Up to three Bubble Memory modules 
can be installed in the 1722A card cage. 



The optional Bubble Memory modules provide the Controller with a 
large amount of additional non-volatile storage capacity. 



WDO: through WD3: are the devices associated with the Winchester 
Disk Drive, an optional 5-1/4” hard disk. It is connected to the 
Controller at the IEEE-488 connector, just as any optional floppy disk 
drives would be. If a 5M byte drive is installed, two devices are 
available: WDO: and WDl:. If the drive is the lOM byte version, all 
four devices are available for additional on-line storage. 

When a Winchester drive is added to a system, the System Generation 
Utility program must be used to create new software to include the 
necessary driver routines. 
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Files 



FILES 

A file is a structured collection of information which the Controller can 
use to hold programs or data for later use. Most of the files supplied 
with the Controller contain programs. The program type is usually 
indicated by the extension (three characters after the filename). 
Extensions are always separated from the filename by a period. 



System files have the SYS extension. Together, they make up the 
collection of programs that are the Controller’s system operation 
programs. 



Alias File 

The alias file is a special type of system file that makes it possible to 
condense long commands into shorter, more easily remembered ones. 
The system alias file (filename ALIAS. SYS) is discussed in geater 
detail in Sections 6 and 7. 



Command Files 

A Command file is a collection of keyboard commands. It has the 
extension CMD. Using Command files makes it possible to automate 
keyboard commands to the Operating System through the Command 
Line Interpreter. 



The Startup Command File 

Command files are powerful tools of the 1722A because they make it 
possible to customize the system. The Startup Command file (filename 
STRTUP.CMD) is executed whenever the Controller is powered up or 
RESTARTed. 

The STRTUP.CMD file on the System disk supplied with the 

Controller checks the time and date clock to see if it has been set, then 
returns control to the Operating System. The Getting Started disk is 
considerably different. Its Startup Commmand file loads the BASIC 
Interpreter program, and then loads and runs a BASIC program called 
the Getting Started program that demonstrates system operations 
without operator intervention. 
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Files 



Other Command Files 

In addition to the Startup Command file, others can be created to 
automatically perform any sequence of keystrokes. The real usefulness 
of a Command file is that it automatically performs commands that 
otherwise would have to be keyed in individually each time the system 
was used. 

Command files are discussed in more detail in section 7, Automating 
System Functions. 



Machine Executable Files 

These are binary machine language programs that can be run directly 
by the microprocessor. They usually use the FD2 extension. Because 
they are actual binary machine instructions, FD2 programs do not 
have to be translated from a higher level language before the 
microprocessor can perform their operations, as other programs must. 

New files of this type are created using an optional linkage 
editor/ loader program. 



FD2 files were called “Core Image Load” files in the 1720A, and used 
the extension CIL. 



Language-Dependent Files 

Each programming language has unique properties just as human 
languages do. Among these unique properties are the file types that 
they use. In an effort to keep this discussion away from individual 
languages, only generic file types are explained. For detailed 
explanations of the file types used by a specific language, refer to the 
individual programming language manual. 



Source files contain programs that are written in high-level language. 
An optional assembler or compiler program translates source files into 
an executable form. 



Object Files 

An object program is the result of the translation of a source program. 
It may be an intermediate step to a machine-executable program, or it 
may be a directly executable form of a program written in a high level- 
language. 
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FUP > 




The File Utility program is a utility software file supplied on the 
System Disk with the file name FUP.FD2. It gives the user control 
over the files in any of the devices. A flexible structure provides other 
useful capabilities. The examples in this section illustrate the many 
ways that the File Utility program can be used. 



Entering the File Utility Program 

From the FDOS) prompt, type FUP (RETURN). The screen will 
display the identification and prompt of the File Utility program: 



FDOS> FUP 

FH# UtilHy Progr«« Vtrcfon i . y 
FUP> 




From the FUP) prompt, type ? (RETURN) to see a listing of the 
command options. 

This command causes the file FUP.HLP to be displayed. As supplied 
on the System Disk, this file is a one-screen summary of command 
options. An error message indicates if the file FUP.HLP is not found. 
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All the command options are listed below with examples. There is an 
explanation of each option later in this section. 





USAGE 


EXAMPLE 


Options 
no option 


Transfer 


MFO:TEST.BAK=EDO:TEST.BAS 


/A 


Assign System Device 


ED0:/A 


/B 


Binary File Copy 


MFO:FUP.SYS=MBO:FUP.SYS/B 


/C 


Configure E-Disk 


ED0:/C (block size) 


/D 


Delete a File 


TEST.TMP/D 


/E 


Extended Directory 


MF0;/E or ED0:/E or /E 


/F 


Format a Disk 


ED0:/F or MF0:/F3 


/L 


List Directory 


MFO:/L or KB1:=ED0:/L or/L 


/M 


Merge ASCII Flies 


TEST.NEW=TEST.1, TEST.2/M 


/P 


Pack a Device 


MF0:/P or ED0:/P or/P 


/Q 


Quick Directory 


ED0:/Q or MF0:*.BAS/Q 


/R 


Rename a File 


TEST.1-TEST.OLD/R 


/S 


Scan for Bad Blocks 


MF0:/S or /S 


/T 


Transfer w/o Error Check 


EDO;TEST.BAD=MFO;TEST.BAS/T 


AN 


Whole Copy 


ED0;MF0:/W 


/X 


Exit FUP 


/X 


/Z 


Zero File Directory 


ED0:/Z or MF0:/Z or /Z 


/+ 


Protect a File 


ED0:1722A.INC/+ 


A 


Unprotect a File 


MFO:RZDZ.WIZ/- 


Switches 

/D, /S 


Double- or Single-sided 
disk format 


MFO: /FD or MFO: /FS3 


/I 


Interactive Switch 


EDO: =MF0; ‘.VI 


Wildcards 






«r 


Match all characters in field 


MFO: *.V-i 


? 


Match single character 


EDO: =MF0: TEST7.BAS 




Unless otherwise specified during formatting, all of the Controller’s 
file-structured devices provide a directory that can contain 72 
filenames. If more files are needed, the File Utility program can 
allocate additional segments for directory space. Each additional 
segment can also contain 72 entries. 

This capability can be particularly valuable when large file-structured 
devices are added {e.g. Winchester drive, RAM Expansion modules), 
or in those cases where a great many small files are to be recorded on a 
floppy disk. Notice that when an Extended Directory Listing (/E) is 
requested for a device with multiple directory segments, the segments 
may be separated by <not used) entries, even if the device is packed. 

The command for allocating additional directory space on the floppy 
disk, E-Disk, or Bubble Memory is /F, followed by the number of 
directory segments desired. Formatting Winchester disks requires 
using the WDUTIL program provided with the hard disk drive. 
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Using the File Utility Program 

If an option affects more than one device or file, the first must be the 
destination, and the second the source. If no device is specified, the 
system defaults to the SYO: device. If no filename is specified, the 
system uses a null filename. Finally, if no extension is specified, the 
system uses the BAS extension. When both a device and filename are 
specified, they are separated by a colon (:). 

The complete name of a file takes the form: 

devifilename.ext 



This is called a pathname. Often, a pathname can be specified without 
directly naming each of its parts. This is done using defaults and 
wildcards, which will be discussed in more detail later in this section. 



CAUTION 



i 



existing fiie 



deleted without 




the specified source. 




destination, it wilt be 



by information from 



This manual uses upper case letters to indicate commands; however, 
both upper- and lower-case entries are allowed. Each command line 
must contain only one command. 

All commands can be automated from FDOS through Command files 
and aliases. 
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Wild Cards * and ? 

A wild card is a character that can be used in place of another character 
or string of characters. The File Utility program can use two wild cards 
in the filename: the ? character, and the * character. Wild cards cannot 
be used when specifying devices, 

^ matches all characters from the wild card until another character 
or the end of the filename or the extension. 

Usage: A*. BAS would match AA.BAS, Al.BAS, and 

AAl.BAS. 

*.BAS matches all files with the BAS extension, 
matches all files. 

Example: To list all BAS files on the floppy disk: 

*/L 

To delete everything stored in the E-Disk: 
ED0:*.*/DI 



? matches any character in that position. 

Usage: A?.BAS matches Al.BAS and AA.BAS, but not 

AAl.BAS. 

Example: To print the BASIC files named TESTl, TEST2, 

TEST3, TEST4, TESTS, TEST6, TEST?, TEST9, 
and TESTA that are currently recorded on the floppy 
disk, using a serial printer conected to the RS-232 
port; 

KB1:=MF0:TEST?.BAS/T 
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Protection States + and - 



All files are assigned a protection state. A protected file (+ state) may 
not be erased or rewritten. It is as if the protected file had a write 
protection tab. If an attempt is made to erase or overwrite a protected 
file, an error message indicates that the file must be unprotected before 
continuing. 

Newly created files are unprotected (- state), to allow them to be 
changed easily. Once the file is complete, or in final form, it can be 
made into a protected file to prevent accidental erasure or write-over. 

The protection states are shown in extended directory listings, and are 
changed with the / + and / - command options. 

CAUTION 

The protection state is Ignored during zeroing (/Z) and 
formatting (/F) floppy disks, and during configuring E-Dlsk 
space (/C). These commands delete all files associated with 
the device regardless of protection state. Be sure to backup 
any desired flies before using these options. 

Example 1. 

To change the protection state of a file called DUTCH. PIM on the 
floppy disk: 

MF0:DUTCH.P1M/ + 

Example 2. 

To unprotect all the files on the system device, using the individual 
switch to insure a message before proceeding: 

* * /-I 
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A switch modifies a command, and always follows it. Three are 
available: the Interactive switch and the disk format switches D and S, 

The Interactive switch permits individual selection of files to be copied, 
transferred, deleted, and protected or unprotected. When the 
Interactive switch is used with a file deletion command, a message 
indicates which files are protected. 

When the Interactive switch is used with the no option command, 
separate the two device names with an = sign. The system requests 
confirmation before completing the transfer. The Interactive switch 
cannot be used with a file merge (/M) command, nor with any 
commands that apply only to a device, such as / A, /C, /S, or /P. 

Example 1. 

To delete selected BAK files from the E-Disk: 



Example 2. 

To transfer selected files from the floppy disk to the display: 

KBO: = MFO: *.*/! 

The “D” switch selects double- or single-sided format for the floppy 
disk. For double-sided, use the argument D after the Format or Zero 
option. For single-sided, use the argument S. See the /F option for 
more details about formatting floppy disks, the /C option for 
information about configuring the Electronic disk, and /Z for details 
about zeroing the directory of any disk device. 

Example 

To format the floppy disk as single-sided, with 5 segments: 
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of Commands 



If no option is specified, a communication channel is established 

between the specified destination and source(s). 

□ Up to eight sources may be specified. 

□ When the destination is a file device (MFO:, EDO:) and no 
destination filename is specified, the names of the source files are 
used. 

□ If the source is not a file device (no name can be identified), the 
resulting destination file will have the null name, unless one is 
specifically named. 

□ If a single file is named as the destination for multiple files, only the 
last file specified will effectively be copied. Use the /M option to 
merge files. 

The examples below show the ways in which the no option Transfer 

command can be used. A short description precedes each example. 



Example 1. 

To make a copy called FILE. NEW of FILE. OLD (both on the System 
Device): 



FILE.NEW=FILE.OLD (RETURN) 

The result will be that two identical files exist, one called FILE. OLD, 
the other called FILE.NEW. 

Example 2. 

The display (KBO:) is specified as destination, and T44.BAS on the 
floppy disk (MFO:) as source. This will display the file. Use Page Mode 
if the file is longer than 16 lines. 



KB0:=MF0:T44.BAS (RETURN) 
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Example 3. 

This command is equivalent to Example 2, if the System Device is the 
floppy disk, and the Console Device is KBO:. By using defaults, 13 of 
the 17 keystrokes have been eliminated in transfering T44.BAS from 
the floppy disk to the display. The default filename extension is BAS. 

T44 (RETURN) 

Example 4. 

To transfer ASCII data from the keyboard (KBO:) to a printer 
connected to an optional serial port 2 (KB2:) In this example, a 
(CTRL) /Z would terminate the transfer. 

KB2:=KB0: (RETURN) 
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/A Assign the System Device 

The / A command option assigns the named device as the the System 
Device, SYO: (the default file device). 

The example assigns the Mini-Floppy Drive (MFO:). 

MF0:/A <RETURN> 



The Binary Transfer option is only implemented to assist those who 
have become proficient using the Fluke 1720A Instrument Controller. 
For normal transfer of 1 722A programs and data, use the no option or 
/T commands. No errors will result. 

The 1 720A / B option transfers binary-coded data, such as system and 
utility software files, lexical-form BASIC programs and virtual array 
files. Up to eight individual source files can be specified, and wild cards 
can be used to increase the number. 

This example uses wild cards to transfer a group of date-coded files (for 
the month of July) named RAC from the Electronic disk (EDO:) onto a 
floppy disk (MFO:). 




The /C option is followed by a number to indicate how many 
blocks of Electronic disk are to be created. An argument of -1 (/C-1) 
allocates all available memory as E-Disk. If the number argument is 
left out, the E-Disk will be de-allocated. An^ argument of zero blocks 
(/CO) also de-allocates the Electronic disk. 



After configuring E-Disk space, use the / F option if more than one 
segment is desired. 



NOTE 

Though specified in blocks, space is allocated by the 
page. Each page (4096 bytes) has 8 blocks, so the actual 
number of blocks allocated will be a multiple of 8. 
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/D Deleting Files 

The /D option is used to delete up to eight specified files (more using 
wild cards). Deleting a file leaves a gap in the file structure. Refer to the 
Pack (/P) command option. When no file is specified, the null file is 
deleted. A single command line can be used to delete files from more 
than one device. 

This example uses wild cards to delete all files having a .TST extension 
from the System Device, and all files whose names start RZDZ from 
the floppy disk. 




There are three ways to list directories. As with all File Utility program 
options, the device must first be specified unless the directory of the 
System Device is desired. If no destination device is specified, the 
Controller assumes that the directory is to be sent to the display. 

Wild cards can be used with all three listings to see only files whose 
names or extensions match, and the directory entry for a single file can 
also be obtained by specifying the file in the command line. 

/E yields an Extended Listing. The extended listing includes all 
unused file areas and the protection state of each file. 

Packing a File Structured Device, below, tells how to restructure 
the disk to remove unwanted blank areas. 

/L is the normal listing of all files on the specified device. It displays 
all 5 fields, but does not include the unused areas. 

/Q gives a Quick listing. It does not display the file size, nor the date 
the file was last updated. The filenames and their extensions are 
displayed, six columns across the screen, rather than one column as 
in the other two types of directory listings. 
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Here is a portion of the extended directory for a I722A System 
Disk: 



f 


(UP NFOl /E 
Clristery of 


KFOi on 


lS-Ju(-B4 


At 0e:36 






.•it 


A 1 


pret 


( 




FS0S2 


.STS 


60 


C*3 


15-MAV-84 




MACRO 


.SYS 


ti 


CO 


13-Aor-64 




ALIAS 


.SYS 


1 


t*3 


04'JAn'B4 




FUR 


.Fbi 


10 


C*3 


09-MAV-84 




TIME 


.FB2 


3 


t*3 


D9-MAV-84 




SET 


.F02 


1.7 


1*3 


D9'M»y'S4 




BASIC 


.FD2 


67 


t*3 


DB'Mav84 




EDIT 


,FD2 


47 


1*3 


DB-M*y-84 




STRTUP 


.C«0 


1 


1*3 


l3-Acr-84 




SYS6EN.FD2 


13 


CO 


09-MAV-84 




FD0S2 


. CF6 


1 


C*1 


15-Dec-S4 




FD062 


.LIB 


102 


C*3 


15-Rav-S4 




6RAPH 


.OBJ 


4 


C*3 


05-Jin-84 




PIBLIB 


.OBJ 


4 


C*3 


Di-Jen-t*. 




COHPAT 


.FD2 


30 


C*3 


06-f^9v~6^ 


\ 


C0NFIQ.FR2 


19 


C*3 


De-Miv-64 



There are five fields: the name and extension of ail the files 
appear in the first two fields. The size field indicates the number of 
blocks the file occupies. Each block is 512 bytes. 

The prot field indicates the protection state of the file, and date is 
the last date the file was updated. 



Two entries may appear in the Extended Directory list that do not 
appear in either the normal list or the quick listing: 



<not used) indicates a blank area within the structure of the disk, 
left when a file was deleted. The Pack command / P packs all 
unused blocks into the end of the segment. 

<temp ent) indicates that some problem occurred when a file was 
open (being transferred or edited). Some typical examples would 
be that the power was removed, or the RESTART button was 
pressed during operation on an open file. The system places a 
temporary entry in the segment to indicate that the file no longer 
exists. To delete the temporary entry, pack the disk with the /P 
command. 
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Here is what the screen looks like when a Quick Listing is done for the 
MFO: device: 




In this example, a quick listing is sent to the optional serial port 2 
(KB2:) of the directory of the floppy disk (MFO:) and the Electronic 
disk (EDO:): 

KB2:=MF0:,ED0:/Q (RETURN) 
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/F Format a File Device 

The /F option prepares a floppy disk (MFx:) or optional bubble 
memory device (MBx:) to receive files by creating a completely new 
magnetic structure on them. Because formatting writes new block 
identification codes and standard data patterns throughout the device, 
any device that is formatted will also be erased. Take care not to format 
disks that have data or programs that you want to save. 

When formatting the bubble memory or a floppy disk, a number can 
follow the / F command to indicate the number of directory segments 
to be established. For more information see the discussion “Directory 
Allocation” at the beginning of this section. If no number is given, the 
default is 1 segment, a useable amount for floppy disks, but restrictive 
for the bubble memory, because it would not take full advantage of the 
large amount of memory available. Since the directory for any one 
segment can contain only 72 entries, selecting one segment results in a 
maximum of 72 files, which is fine for most floppy disk applications, 
but is not an efficient use of the mass storage available in bubble 
memory or Winchester hard disks. 

If a disk has suffered media damage, a message will display indicating 
that it is not able to be formatted. If this happens, the disk is not 
useable and should be replaced. 

This option formats either floppy or Electronic disks, or Bubble 
Memory devices. 

Example 1: 

This example formats, zeroes, and verifies a floppy disk: 

MF0:/F < RETURN) 

Example 2: 

This example formats a bubble memory device with 12 segments (864 
possible files): 

MB0:/F12 (RETURN) 

Example 3: 

This example uses the double-sided switch to format a floppy disk as 
double-sided, with 6 segments: 



MF0:/FD6 
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Besides its use as a command modifier, / 1 can be used alone to transfer 
files interactively. Just as with other transfer commands (no option, 
/B, and /T), wildcards are allowed. If no destination is specified, the 
default device is KBO:. If no source pathname is given, the System 
Device SYO: and the null file are assumed. 

Example: 

This example transfers selected files from the E-Disk to the floppy 
disk. 



* * 



/I 



E for all directory listings. 




The /M option merges up to eight ASCII source files into one 
destination file. Binary files, such as System and utility software files, 
lexical form BASIC programs (BAL extension), and virtual array files 
cannot be merged. The source files remain intact, unless the destintion 
has an identical filename (on the same device). Wild cards and the 
Interactive switch cannot be used. 



When the destination is a non-file device, the /M option removes the 
(CTRD/Z character (ASCII EOF) from the end of all but the last file. 



encounters a duplicate 




r* 



to 




Example 2. 

This example appends keyboard input directly to the end of an existing 

file without creating a new one. The destination file DEST.CPT 
contains the old file DEST.CPT followed by keyboard inputs. A 
keyboard entry of (CTRL)/ Z terminates the keyboard portion of the 
input. 



DEST.CPT=DEST.CPT,KBO: / M (RETURN) 
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The /P command option reorganizes a file-structured device. When 
files are deleted, blank areas are left within the file structure. (See /F 
for more information.) The /P option compacts these areas into one 
contiguous space. It may be possible to make room for a file that 
previously wouldn’t fit by packing the device. When this option is used, 
the file structure is maintained. During packing, the keyboard is 
disabled from display, but keystrokes are buffered. This feature makes 
it possible, for example, to give the command /E during packing. 
When packing is complete, the extended directory listing will display. 




The / R option is used to rename a file. It has no effect on the size or 
location of a file, because it only operates on the directory. 

This example renames the file TEST4.BAS on the System Device to 
PROG.T4: 

PROG.T4=TEST4/R (RETURN) 

/S Scanning for Bad Blocks 

The / S option scans a file-structured device for bad blocks, and sends a 
result message to the specified destination. Each block is read and 
checked for errors. A check character is compared with one recorded 
with the block. Any mismatches cause an error message. 

Scanning for bad blocks is done to check for a faulty floppy disk or 
Bubble Memory device. If you are having trouble reading or recording 
on a disk, use the /S option to determine if the disk is useable. If bad 
blocks are indicated, attempt to transfer the files to another disk, then 
discard the faulty one. Bad blocks are a result of wear, age, or abuse. 
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If no destination is specified for the result, any errors found will be 
displayed on the console. 

To scan the System Device and see the results displayed: 

IS (RETURN) 

This example scans the floppy disk and sends the results to serial 
port 1: 

KBI:=MF0:/S (RETURN) 

/T Transferring Files Without Error Check 

Except for inhibiting error checks, this command is identical to the no- 
option command. It transfers files just as the no-option command 
does, but does not check for device errors. If errors should occur, they 
are ignored, and the file is transfered as is. This option can be used to 
create backup copies of files that are suspected to contain errors. 



/W Whole Copying a File Device 

The / W option transfers some or ail of the files on a file device at one 
time using a single command. This option simplifies duplicating a 
floppy disk. 



The source and destination devices should be different. (If they are the 
same, the result would be merely to record a file back to the same place 
it was read from.) To duplicate all or part of a floppy disk, first copy 
files into EDO:. Then insert a formatted disk and copy from EDO: to 
MFO:. 

If the disk already contains files having the same name as those being 
copied, the whole copy command deletes the existing file and replaces 
it with the one being copied. 

If E-Disk space is less than the total size of the files to be copied, break 
the task into smaller parts by copying only some of the files on several 
passes. 
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The display indicates the name of the file being copied. The whole copy 
process can be terminated before ail files are copied by typing 
(CTRL) /C during the copy of the last file desired. The file copy in 
progress will be completed before the operation stops. 




In this example, a whole copy is started by temporarily placing the 
floppy disk contents into E-Disk storage. The wild card character 
indicates the name of the first file to be copied. Note the display for the 
last file copied, in case a second pass is needed. 

ED0:=MF0:TEST.*/W (RETURN) 

In the second part of the example, the floppy disk is exchanged for the 
one which will contain the copied files. After noting the last file copied, 
insert a disk that has been formatted (see / F ). This command line then 
copies the files to the disk from the E-Disk. 



If a second pass is needed, first zero the E-Disk (see /Z option below). 
Now use the * wild card to start the whole copy again, beginning at the 
first file that matches the wild card. 

Notice the subtle difference in how the * wildcard character operates in 
a whole copy from its normal use in transferring, copying, deleting, 
protecting, and so forth. When used with the Whole Copy option, the * 
in the filename indicates that the copy is to begin with the first file that 
matches the extension. 

For example, the command MF0:=ED0:*.BAS/W would not 
necessarily copy all the files with the BAS extension, but would begin 
the whole copy with the first file that had a BAS extension. 
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/X Exit 

This command exits the File Utility program, and returns control to 
the shell. 

/Z Zeroing a File Directory 

The /Z command zeroes the directory of one or more file devices. 

The result of the /Z option is similar to the /F option if the device is 
already formatted: no files are accessible when the operation is 
complete. However, formatting is more time-consuming, and is not 
necessary if the intent is merely to delete all files from a device. 

Zeroing is not equivalent to formatting. The files remain after zeroing a 
directory, but they are not able to be accessed because there is no 
directory. After zeroing, the device retains the prior format. 

Because zeroing deletes the directory of all files from the specified 
device, the program requests an affirmative before proceeding. Entries 
accepted as affirmative are YES, Y, yes, and y. 

If a floppy disk or bubble memory are zeroed, the number of directory 
segments does not need to be specified, because the current structure 
remains intact. 

This example zeroes the Electronic disk (EDO:) 



This example zeroes the directory of the Electronic disk, and creates 
four segments: 



ED0:/Z4 (RETURN) 
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/+ and /- Assigning Protection State 

The /+ and /- commands change the protection state of a file. 
Directory listings indicate the current state inside brackets, and the 
system automatically assigns the unprotected state (-) to newly created 
files. A file must be unprotected before it can be deleted. 

This example protects a file called SHDS.PAT that is currently 
recorded in the bubble memory: 

MBO:SHDS.PAT/+ (RETURN) 

This example uses a wild card to unprotect all files in the System device 
having a TMP extension. The Interactive switch ensures that 
confirmation is given before the unprotection. 



*.TMP/-I RETURN 





□ A pathname can include device + filename + extension. 

□ Ail directory listings can use wildcards. 

□ If the device is not specified in the source pathname, the system 
device or the last device specified will be used. 

° If no destination device is specified, the default is to KBO:. 
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File Transfer 




Commands 




□ A pathname can include device + filename + extension. 

o All transfer options can use the Individual Switch and wildcards. 

□ If the device is not specified in the source pathname, the system 
device or the last device specified will be used. 

o If no destination device is specified, the default is to KBO:. 



File Rename Command 



(null tile) 



destination 

device 



o 



(null tile) 



source 

pathname 













o Wild cards and the Interactive switch are not allowed. 




□ Wild cards are allowed for the source filenames. 




□ If device is not specified in the pathname, the system device or the 
last device specified is used. 



□ The Interactive switch can be used to insure confirmation is 
requested before deleting or changing the protection state. 




are 









List Bad Blocks Command 

lKWf;> (SYlf:) 




□ If device is not specified in the pathname, t 
last device specified is used. 



o Wild cards are allowed. 



(SYJ?:) 




a 



(current) 
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segments 
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System Messages 

Messages from the system are a normal part of operation, and do not 
always signify that an error has been made, though they are generally I 

referred to as “error messages”. Here are the meanings of messages you | 

might see from time to time when using the File Utility program. The j 

messages are listed alphabetically: 


MESSAGE 


MEANING j 


? Dev ice error 


A non-recoverable error was detected 
during transfer to or from the floppy 
disk or Electronic disk. This may also 
occur when writing on an unformatted 
floppy or Electronic disk. 


?Devic8 not ready 


The device is not ready. This usually 
means that the disk is not inserted, or 
the disk drive door is not shut. 


7 Devices do not Match 


A rename was attempted for files not 
on the same device. 


? Directory avsrf ley 


Two many files exist for another to be 
copied or transferred to the device 
because the drectory is full. To recover, 
first backup all files, then use the /F 
option to reformat a disk with more 
segments. - 


^File already exists 


A rename was attempted using a file 
name already in use. 


7Fi If protected 


The specified file has a + protection 
state assigned to it. Use the /- 
command option to unprotect the file j 

before deletion. 


? Hffl|B file not available 


A was entered and the file I 

FUP.HLP could not be located on the 
System Device. 
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?IUfgal f 1 It/dtvloi naas 



TlUegal dfrtotary 



Tlllegat option 



?inegsl option for dfvic* 



? Input qutut overflow 



?No end-of-file 



?No roo» on device 



7No such device 
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A name in the command contains too 
many characters or contains characters 
other than letters, numbers, spaces, or 
signs. 

The directory on the device is faulty. If 
the device is a floppy disk, it is 

damaged and should be replaced. 
Backup all files first using the /T 
option. 

The command option selected was not 
recognized. This is usually caused by 
typing errors. 

A command was given that would be 
legal for some other device, but not for 
the one specified. 

An option was specified for a device 
that does not accept the format. For 
example, attempting to zero the E- 
Disk as double-sided. 

The RS-232 port was receiving data, 
and some of it was lost. Use the Set RS- 
232 Utility program to slow down the 
baud rate or to enable the Stall 
Input/ Output feature. 

An ASCII source file was not 
terminated with (CTRL) /Z. Can also 
be caused by running out of storage 
space before the (CTRD/Z is 
transferred. 

A copy or merge operation was 
attempted, but the resulting file would 
not fit on the specified device. 

A device was specified that is not on the 
list of recognized devices at the 
beginning of this section. This is 
usually caused by misspelling. 
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7 No such file 



?Not enough aenory 



■^Wedium changed 



7Nuaber too large 



7Sys'tea error 



7Syntas error 



7 Too many files 



7Wrfte protected 



The file could not be found on the 
device specified. This is usually caused 
by misspelling, although the wrong 
device may have been specified. 

An attempt was made to configure 
more E-Disk than is available in 
memory. 

The disk drive door was opened and 
the disk removed during a read or 
write operation. 



The number specified in the command 
is too large. This message occurs if the 
number of directory segments specified 
is more than the device is able to 
contain. 



This error should not occur under 
normal use. It indicates an error in the 
operating system or the File Utility 
program. Contact a Fluke Service 
Center and make an accurate report of 
the conditions at the time the error 
ocurred. 



The form of the command input does 
not match the requirements of a File 
Utility program command. This is 
normally caused by typing errors. 



More than eight source files were 
specified. Either break the task into 
smaller parts, or use wild cards. 

A write operation was attempted on 
the floppy disk, but it has a write 
protect tab. 
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The Touch-Copy Program is called TCOPY, and is provided on the 
System Disk with the filename TCOPY. FD2. TCOPY lets use you use 
the Touch-Sensitive display to transfer files between any of the 
Controller’s file-structured devices. TCOPY is easy to learn and use 
because the program is totally menu-driven, and provides help 
information about every command and option. 

TCOPY does some of the things that are possible with the File Utility 
Program, but it is better suited than FUP for many special copying 
applications. For example, to use FUP to make a copy of an entire 
floppy disk first requires configuring memory space as E-disk, then 
using a whole copy command to transfer the files there, then swapping 
disks, and finally, using whole copy again to transfer the files from E- 
disk to the new floppy. On the other hand, TCOPY does not require a 
lot of typing, but presents menu selections to touch, considerably 
simplifying and speeding up the process. 
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TCOPY has only two commands, DIRECTORY and COPY. The 
directory command prints a listing of the files on a device. The copy 
command lets you copy various files from one file-structured device to 
another. Even if you only have one disk drive and no memory 
expansion options installed, you can still make a copy of a disk. 

To choose an option, simply touch a box. To erase a command any 
time before STARTing it, touch the CANCEL box to return to the 
main menu. At this point, you can start entering a new command or 
touch QUIT to leave the program. 



If you ever forget what the different commands and options do, use the 
help facility to get a description. When you touch the HELP box in the 
main menu, a list of topics appears. Select the topic by touching a box. 
Most topics also require the selection of a subtopic. 



MRECTORY Command 

Usually' the first thing to do before copying a disk is to check the 
directory to make sure the proper disk is in the drive. The next few 
pages describe the DIRECTORY command and its options. 



TO LIST A DIRECTORY 

With the main menu on the screen, touch the DIRECTORY box. A 
new menu appears, allowing you to choose the device which you want 
listed. The two boxes that indicate the system device are highlighted. If 
this is the device you want to select, just touch the START box. If it is 
not, first touch a device name box (top row), and then a device number 
(middle row). 

When you press START, a list of the files on the selected device 
appears on the screen. The list includes the size of the files in blocks, 
their creation dates, and a plus sign if the file is protected. Touch the 
CONTINUE box to proceed to the next page or to return to the main 
menu from the last page. 
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DIRECTORY OPTIONS 

A number of DIRECTORY options let you limit or change the list of 
files to be displayed. To use them, repeat the steps for displaying a 
directory listing, but touch OPTIONS instead of START after you 
choose the device. When an option has been entered, the program 
returns to the option menu. To begin the directory listing, touch 
START. 

Each of the DIRECTORY options are described in the following 
paragraphs. 



□ Displaying a Short Directory List 

The SHORT option gives a more compact directory listing by 
omitting the file protection, size and creation date fields (like the 
FUP IQ option.) 

Q Selecting Files by Creation Date 



i. Select the type of limitation needed: whether you want files 
that were created BEFORE, ON or AFTER a date. Another 
menu appears to allow you to choose the date. 
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2. The next menu shows today’s date in three boxes on the top 
row of the screen. To change the month, date, or year, touch 
one of the three boxes, then use the arrows to change the value 
in that box. You can then select a different part of the date to 
change. When the date you want is in the boxes, touch the 
START box. 



NOTE 

The selected dale is not inclusive for the BEFORE and A FTER 
options. Files created on that date are not listed. To select files 
between two dates, combine the BEFORE and AFTER 
functions. To do that, touch AFTER, then select the earlier 
date. Now touch OPTIONS (insteadof START), then DATE, 
and select BEFORE. Finally, select the later date and touch 
START. 

□ Selecting Files by Size 

Selecting files according to their size works almost the same way as 
selecting them by creation date. Touch the SIZE box, and then 
either SMALLER, LARGER or EXACT. A size in blocks appears 
in the top box on the screen. Use the arrows to change the size. 
When the desired size is highlighted, touch the START box. 

o Selecting Files by File Type 



If you want to limit the listing to particular file types, touch the 
FILES box on the options menu. Then choose from one of the 
twelve file types on the screen and touch the START box. 



SORTING THE DIRECTORY LIST 

Normally the files in a directory list are unsorted. They appear on the 
screen in the order they occur on the disk. It is possible to sort the files 
in three ways, though, To use any of the SORT options, select the 
option by touching the appropriate box in the OPTIONS menu. 

SORT NAME Sorts the directory list alphabetically by filename. 

SORT DATE Sorts the directory list by creation date. The most 
recently created files are listed first. 

SORT SIZE Sorts the directory by file size. The largest files are listed 
first. 
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The COPY Command 

The COPY command makes copies of some or all of the files on a 
device, it reads as many files as it has room for from one device and 
records them to another. This cycle repeats until all files are copied. 

If the source and target devices are the same^ and have removable 
media (such as a floppy disk) then TCOPY will prompt you for the 
source and target disks when they are needed. If the device does not 
have removable media, but the source and target devices are the same, 
TCOPY will report an error and the copy operation will not be 
performed. 



COPYING AN ENTIRE DISK 

Y ou can copy an entire floppy disk even if you only have one disk drive. 
This type of copying may require changing the disk a few times. Follow 
these steps to copy an entire disk: 

1 . Make sure that you have the disk you want to copy (the source 
disk), and a blank, formatted disk (the target disk). See the 
FUP /F option for directions on how to format disks. 

2. Start up TCOPY and when the main menu appears, touch the 
COPY box. The device menu appears, allowing you to select 
the device from which you want files copied. If mfO: isn’t 
selected, touch MF and then 0:. 

3. Touch CONTINUE. The device menu reappears to permit 
selection of the device to which the files will be copied. Again, 
make sure mfO: is selected. 

4. Touch START. TCOPY now prompts you to insert the source 
disk. When you’ve done that, touch the box on the screen. The 
program begins reading files into memory. When memory is 
full (or when the entire disk is in memory), TCOPY prompts 
you to insert the blank target disk. This cycle repeats a few 
times until all the files on the source disk have been copied. 
When the entire copy is complete, the main menu displays 
again. Use the DIRECTORY command to list the files that 
were copied. 




The COPY command has a number of options. To display a menu that 
shows them, follow the instructions for the COPY command, but end 
with OPTIONS instead of START. Three of the options (SIZE, 
DATE and FILES) work exactly as they do for the DIRECTORY 
command, limiting the copy to a desired group of files. 

o INDIVIDUAL 

Use the INDIVIDUAL option if more precise selection is needed than 
the SIZE, DATE, or FILES options permit. When this option is used, 
TCOPY requests confirmation before copying each file. 



TCOPY can record onto a disk that is not blank. Unprotected files on 
the target disk with the same name as a selected file on the source disk 
will be deleted without warning before the file is transferred. 

□ If a protected file is found on the target disk, TCOPY asks for 
permission before overwriting the file. The first time it asks, 
TCOPY also offers the choice of treating all protected files the 
same way. 




o If you elect to overwrite the first protected file on the disk, the 
program asks if you want all protected files overwritten. If you 
respond YES, then TCOPY will overwrite the rest of the protected 
files without warning. If you answer NO, then TCOPY continues 
to ask for overwrite permission. 

n If you decided not to overwrite the first protected file, then TCOPY 
asks if you want all protected files skipped. Answering YES causes 
TCOPY to skip over all files protected on the target disk. By 
responding NO, you direct TCOPY to continue asking for each 
protected file. 



onaf Features 

Besides the DIRECTORY and COPY commands and their options, 

the TCOPY program has some other features that can help simplify the 
task of copying files and disks. The next two topics describe these 
additional features. 



Up to 15 options can be chosen for either a DIRECTORY or a COPY 
command. One example of this feature was given in the description of 
the DATE option. Here’s another example: say you want a directory 
listing of all the binary machine language files larger than 10 blocks 
and created after August 30, 1984. Touch the boxes shown below. 




*.FD2 

LARGER (scroll the number of blocks 
to read 10) 

AFTER (scroll the date to read Aug 30 
1984) 



If no files fit all these conditions, TCOPY displays the message “No 
files match pattern”. 
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ENTERING TCOPY COMMANDS FROM THE KEYBOARD 

Besides using the menus, there are two other ways to give commands to 
TCOPY. 

The first way is to type the entire command from the FDOS prompt. 
For example, from FDOS, you can type: 

TCOPY DIR *.ABC (RETURN) 

to get a directory listing of all files having the extension ABC. This 
method returns to FDOS after the TCOPY command has been 
executed. 



The second method of using TCOPY without the menus is to use the -C 
option. This option puts you in TCOPY command mode. From 
FDOS, type: 



The TCOPY prompt appears. Now any TCOPY commands can be 
typed directly. This feature is convenient once you become familiar 
with the various capabilities of TCOPY, because it can be quickerthan 
working through the various menus. 

As an example, if MFO: is the system device and you type: 

COPY FUP.FD2 (RETURN) 

from the TCOPY prompt, you will copy the File Utility Program 
from one disk to another. The screen still prompts for the source and 
target disks, just as the menus do. 




To use a sorting option with commands entered from FDOS, or from 
the command mode, the word “sort” must appear, followed by the type 
of sort. For example, to list all the files on the E-Disk that were created 
after October 3, 1984, and sort the list alphabetically, use: 

DfR EDO: AFTER OCT 3 1984 SORT NAME (RETURN) 

All words, except for months (which must be at least 3 letters) can be 
shortened to 2 letters and must be separated from each other by a 
space. 



QUIT (RETURN) or EXIT (RETURN) 



USING TCOPY IN A COMMAND FILE 

When TCOPY is called from a command file, it comes up in command 
mode by default. This allows subsequent lines of the command file to 
provide input to TCOPY as if they were typed from the keyboard. 



If you want to call TCOPY from a command file and use the menus, 
you must use the -M option. The line “TCOPY -M” will accomplish 
this. 

Note 



If TCOPY is called as the last command in a command file, it 
must be followed by a blank line. Otherwise TCOPY will start 
up in menu mode if no option is specified. 




The TCOPY program returns the same error messages as FUP. For a 
complete description of these messages, refer to “System Messages” 
under the File Utility Program earlier in this section. 

In addition, the following messages are returned by the TCOPY 
program: 



Can’t find help on that topic. 

Can’t open help file. 

Extra command. 

Illegal date. 

No files match pattern. 

Source and target devices 
are the same. 

Temporary files on device. 



The help file has been changed or 
overwritten, and the help for that 
particular subject is missing. 

The help file (TCOPY. HLP) is 
missing. 

Only one command (DIRECT- 
ORY or COPY) can be given at a 
time. 

An illegal date was entered, or a 
year before 1972 or after 2003 was 
specified. 

No files were found on the source 
disk that matched the patterns 
and/or limitations given. 

If the target device does not have 
removable media (i.e. floppy 
disk), then it must not be the same 
device as the source. 

Can only be removed by packing 
the device. Only a warning. Does 
not halt execution of the 
command. 




Too many source devices listed. 
Too many words. 

Unknown option. 



Only one source device may be 
listed. 

Only 15 words may be entered 
from command mode. 

TCOPY was invoked with an 
unknown argument. 



CLUsior^ 

This section has described the Controller’s resources in some detail, 
and explained how to use the File Utility and TCOPY programs to 
manipulate files. The devices can be thought of as names for the 
various hardware parts of the system. Files are programs. 



The next section, Communications, details the way that information 
can be sent out of the Controller, or brought into it by means of two 
industry-standard connection methods: the IEEE-488 
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The Controller communicates in two ways: by way of the IEEE-488 
General Purpose Instrumentation Bus, and the EIA RS-232-C Data 
Communications Interface. 

These two standards were developed to serve two different purposes; 
the IEEE-488 as a standard connection between measurement 
instruments, and the RS-232 as a standard connection for serial data 
communications. 
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In 1975, the Institute of Electrical and Electronic Engineers (IEEE) 
published a “Standard Digital Interface for Programmable 
Instrumentation Systems”. This standard was revised in 1978, and a 
supplement was published in 1 980. The IEEE-488 standard has gained 
acceptance throughout the instrumentation industry because it 
permits a wide variety of measurement equipment to be connected 
easily to form a programmable instrumentation system. The 1722A 
implements the most recent version, including the 1980 supplement. 

The IEEE-488 standard describes a bus architecture and defines the 
timing and handshaking that occurs on the bus. Devices connected to 
the bus may be talkers, listeners, or controllers. 

The I722A is able to control up to 14 instruments directly from the 
single standard IEEE-488 connector. An additional Interface module 
can be added to allow the 1722A to control more instruments. 

The next few pages describe how the interface operates. Much of this 
discussion is theoretical, and has been included here to help first time 
users visualize an instrumentation system. Though it may appear that 
the operation of an IEEE-488 system is a complicated matter, in fact it 
is quite easy to use, and most of the details of bus operation are 
transparent to the user. 
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The Controller establishes the role of each of the connected 
instruments by sending commands to them and setting up the correct 
communications channels. Each piece of equipment recognizes its own 
address, which is set into it by configuration switches when the system 
is assembled. Each connected instrument can then respond to polling 
and receive or send data. Depending on its role in the system, each 
instrument can also perform these functions; 

□ Handshaking to establish and confirm the connection 
o Single address talking or listening 

□ Request service to notify the controller that a function is complete 

□ Respond to poll to answer the controllefs request for status 

□ Clear to return to a default state 

o Trigger to respond to the controllers command to perform a 
function 



The controller can perform these functions: 

□ Command devices to listen, talk, or perform a function 

□ Trigger devices to perform a pre-programmed function 

□ Clear devices to an initial state (defined by the device) 

o Poll devices for their status serially or in parallel 
(one device at a time, or all at once) 

□ Command devices to abort current operations 

□ Command devices to enter the remote mode of operation 

□ Pass control to another controller 
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nterface 

There are 16 signal lines on the IEEE-488 bus; all are active low TTL 
levels. The lines are divided into three categories: 

1. Eight data lines 

2. Three handshake lines 



For your reference, Appendix C has a pinout diagram of the standard 
interface connector and a description of each of the lines. 

Bus Operating Modes 

The bus operates in either command or data mode. A controller uses 
the command mode to control the various instruments connected to 
the bus. A talker or a controller uses the data mode to transfer 
information or device dependent commands on the Data I/O lines. 
The three handshaking signals officiate transfers on the bus. 



The controller places the system into Command Mode by sending an 
attention signal. All devices on the bus must then interpret the data 
byte as a command message. Only a controller may issue commands. 

There are four types of commands: 

1. Addressed Commands (all devices are addressed to listen). 
These are used to control a selected group of devices. The 
command is preceded by a device address, because only those 
devices previously commanded to listen must respond. 

2. Universal Commands (all devices). 

These commands are used to control all system devices. They 
do not need to be preceded by an address because all devices 
that are able to must respond to them. 
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3. Addresses (all devices). 

The controller uses these commands to designate devices as 
talkers or listeners. 

4. Secondary Commands (all devices are enabled by a primary 
address or command). 

These are the second byte of a two byte address, and are used 
by the controller to implement “extended” talk and listen 
functions. Secondary commands are used to send a second 
address if the primary address has been accepted as part of the 
address command. 

Each type of command has a specific function in the activity of the bus, 
and they are all designated by three letter mnemonics. Ail of these bus 
functions are implemented in each of the programming languages 
available for the 1722A. In some cases, a single command performs 
more than one function; for example, the Fluke Enhanced BASIC 
command TRIG (Trigger) addresses a set of instruments as listeners 
and then triggers them. 



Appendix C contains a complete listing of the Command Messages. 
Refer to the appropriate programming language manual for 
information about how to implement each of the commands in a given 
language. 
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The controller places the system into the data mode by setting the 
attention line false. In this condition, all devices treat the information 
on the bus as data. This data can originate from either a talker or the 
controller. Data can flow from device to device on the bus (talker to 
listener) in any mutually understood code or format, or the I722A can 
act as an interpreter, accepting data from the talker and sending it out 
to a listener. 
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In this example system, a sequence of events describes how a specific 
measurement task would be accomplished. In general terms, the 
Controller programs the instruments and initiates the measurements. 
The resulting data is returned to the Controller, which then routes it to 
the serial printer for printout. 



1. The Controller initializes the interface devices. 

2. The Controller commands all devices to set their internal 
conditions to a predefined state by sending a device clear 
message. 

3. The Controller sends the listen address and program data to 
the frequency synthesizer. The program data tells the 
frequency synthesizer the output frequency and level. 

4. The Controller sends the unlisten command to the synthesizer, 
then sends the listen address and program data for the 
frequency counter. (Function and range, for example.) 

5. The Controller sends a program code to trigger the 
measurement. 

6. The Controller sends the unlisten command, addresses itself to 
listen, then sends the talk address of the measurement device. 

7. When it completes its internal measurement cycle, the 
frequency meter sends a request for service to the Controller. 
When its request is recognized, it sends (talks) the 
measurement data to the addressed listener, the Controller. 

8. Under program control, the Controller gathers the 
measurement data and sends it via the RS-232 port to the 
printer (first addressing the printer as a listener, as before). 

This example shows how a typical system is connected and describes 
the way the Controller directs the tests. The program required to 
actually do these steps depends on the programming language used. 
Each programming language manual includes examples such as this 
one to assist the programmer. In Section 7, Automating System 
Functions, a BASIC language program is developed that will show 
how a test program might be written to test this system. 
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The basic system can be expanded by adding options to the Controller 
so that many more instruments can be connected. These options 
provide a great deal of flexibility to the system designer. For example, 
the RS-232 ports could be used to transmit the data via a modem to a 
larger computer for analysis. Because of this flexibility, it is 
recommended that you consult your Fluke representative in the early 
design stages so the final system will perform efficiently in your 
application. 



ipie 




At power up, the 1722A can be designated either as the “system 
controller” or as an “idle controller” on an IEEE-488 port. There can 
only be one system controller on a port and it is the only device 
connected that is able to drive the control lines IFC (interface clear) 
and REN (remote enable). Likewise, there is only one “controller in 
charge” on a port at a time and it is the only device that can send 
interface messages by setting the ATN (attention) line true. The system 
controller is the controller in charge when it is powered up. 



The controller in charge can pass control to an idle controller. When 
this happens the idle controller becomes the controller in charge and 
the former controller in charge becomes an idle controller. If the 
system controller sets the IFC line true, it gains control on the port and 
becomes controller in charge. 



A switch on the Single Board Computer module (slot 7) designates the 
power up condition of the 1722A either as the system controller or as 
an idle controller. The other switches of SWl set the I722A default 
baud rate (the rate used unless changed by the SET Utility program), 
and the 1722A’s IEEE-488 bus address. Refer to the following drawing 
to set the switch. 
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488 COMMUNICATIONS UNDER PROGRAM CONTROL 

Each programming language available for the 1722A Instrument 
Controller includes specific commands to handle the IEEE-488 
communications. The standard was developed to permit the easy 
connection of an instrumentation sytem, but two important rules 
should always be kept in mind as you begin programming: 

1 . There may be any number of listeners at a given time. 

2. There may only be one talker at a time. 

There are other constraints, but these mostly depend on the 
capabilities of the connected instruments. An example is the Fluke 
8502A Digital Voltmeter, which must be allowed a three-second wait 
between the time it is reset and the time it is programmed. Be sure to 
adhere to the requirements of each particular instrument to simplify 
your programming task. 
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xample Commands from the BASIC Language 

Here is a synopsis of the commands used in Fluke BASIC to control 
communications over the IEEE-488 bus. For complete definitions and 
requirements, see the BASIC Programming Manual. 



IMIT 


Initializes the bus. 


CLEAR 8 n 


Addresses the specified device number as a listener, 
and issues a selective device clear. 


yAiT 


Followed by a number, suspends program execution 
for the length of time indicated (milliseconds). 


INPUT a R 


A command string (in quotes) following this command 
addresses the instrument as a listener, and programs it. 


PRINT 3 n 


A variable follows this command to address the 
instrument as a talker, and return the measurement 
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mple BASIC Program 

This sample program shows how the most important bus commands 
would be included in a BASIC language program to take a reading 
from the Fluke 8502A Digital Voltmeter. Some features of the 
program are: 

□ Between resetting the meter and sending it program data, there is a 
5-second wait to allow the meter to stabilize. 

□ Ten readings are taken to insure accuracy of the returned 
measurement data. 



□ A 3-second wait is inserted between the last reading and the display 
of measurement data. 



10 I Program for Fluk» 8502A Digital Voltmeter 



30 


DIM R (9) 






40 


INIT PORT 


0 




50 


CLEAR ® 2 






60 


WAIT 5000 






70 


PRINT 82, 


-'VR2T0” 


80 


FOR 17. = 07. TO 


97 


90 


PRINT 


® 2, 


" 7 " 


100 


INPUT 


9 2. 


R (17.) 


no 


NEXT 17. 






120 


WAIT 3000 






130 


FOR 17. » ( 


)X TO 


97. 


140 


PRINT 


17. j 


R ( 17.) 


150 


NEXT 17. 






160 


END 







dimension array 
initialize the bus 
clear instrument 2 (DVM) 
let DVM settle 
program DVM 

set up loop for 10 readings 
trigger DVM 

get reading, send to array 

go back to 60 for next reading 

let bus settle 

loop to display readings 

print value of I 

return for next value 
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Here is a line-by-line explanation of the sample program: 

10 Program identification. 

20 Blank line for readability. 

30 Dimensions an array called R to hold up to ten readings (0-9). 

40 Initializes Port 0, the built-in IEEE-488 bus. 

50 Clears and addresses as a listener the DVM whose address is 2. 
(Set up by switches in the instrument.) 

60 Wait for 5 seconds to allow the DVM enough time to respond to 
the clear signal, and to set up internally as a listener. 



70 Programs the instrument with the command “VR2T0”, which 
this particular instrument reads to mean, ‘use 10 volts DC scale, 
and take single readings synchronously with the line (60 Hz)’. 




90 Addresses 2 as a listener, and sends a “?” which triggers the 
measurement. 



100 Addresses 2 as a talker, and puts the returned reading into the 
location specified by 1% within array ‘R’. 

1 10 Program returns to line 80, which increments the value of 1%, so 
that as the FOR-NEXT loop is repeated, the next reading goes to 
the next available location in the array R. After ten passes 
through the loop, the program continues at line 120. 

120 All measurements are complete, so this program step waits 3 
seconds for the bus to settle. 

130 Sets up another FOR-NEXT loop to display all ten readings. 

140 Prints each value of 1% within the array R. 

1 50 Sends program back to line 1 30 to increment 1%, and display the 



next 




In actual practice, this program could be greatly simplified. It is shown 

here for illustration purposes only, although it could be used as is. 

Some of the simplifications might be: 

□ Trigger the DVM ten times, but then send a command to have it 
average the readings (many programmable instruments include 
such mathematical abilities). The DVM would then return the 
average, rather than ten readings. 

□ If the meter is unable to perform the mathematics, have it return all 
ten readings, but finish this subroutine with a branch to an 
averaging subroutine, and display only the average. 



ore Information 



System designers and programmers who are unfamiliar with the IEEE- 
488 standard should obtain a copy of Fluke Application Bulletin 36 
{IEEE Standard 488-1978 Digital Interface for Programmable 
Instrumentation), and Technical Bulletin C0076 {Troubleshooting 
Information for IEEE-488 Systems). These publications provide the 
background needed to set up an IEEE-488 system. Appendix C of this 
manual provides useful reference material covering the interface 
connector, handshaking protocol, commands, and message formats. 



For an in-depth study of the IEEE-488 standard, a copy can be 
obtained by writing to the Institute of Electrical and Electronic 
Engineers, Inc., 345 East 47th Street, New York, NY, 10017. 
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.ERSAL COIVIMUNICATIONS 

The RS-232 ports are connection points for devices that use the 
Electronic Industy Association‘s RS-232C Data Communications 
Interface Standard. Since it was first published, the RS-232 standard 
has gained wide acceptance among manufacturers because it allows 
various brands of equipment to use serial data communications to pass 
information. 

The standard describes the physical connector, the signals on each pin 
of the connector, timing requirements, and the voltage levels of the 
signals. 

The standard allows variations to accomodate different applications. 
Therefore, the 1722A software includes a program called the Set 
Utility program that permits changing the values of the parameters at 
the port. 

et Utility Program 

The purpose of the Set Utility program is to configure the Instrument 
Controller to enable it to communicate with virtually any other piece 
of equipment that uses the RS-232 standard. The port parameters are 
set to default values when the Operating System is loaded, and some 
applications will not require changing the defaults. 

These are the port characteristics that can be changed: 
o Baud Rate 

□ Number of Data Bits 

□ Number of Stop Bits 

□ Parity 

□ End of Line and End of File Terminators 

□ Stall Input/Output Enable/ Disable 



□ Time Out Value 
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Here is how to use the Set Utility program: 

1. From the FDOS) prompt, enter: 

SET <RETIJRN> 

2 . The screen will displav the promot: 



FOOS> SET 

S»t Virs !OH X .V 



f 






' SET> KB55LI 


Device 


KBl! 




Baud Rate 


9600 




Data Bits 


S 




Parity 


Even 




Stop Bits 


1 




End of tine 


50 




End of File 


26 




StaU Input 


(Msabltid 




Stall Output 


enabled 




T(a» Out 

S. 


0 


J 



5. To exit the Set Utility program, type: 
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A help command lists all the availab 
? (RETURN) to see this display: 



Cocaand Argruatnt 



BR 75.1101 134. 5* 150«300.600«ljJ0D.ie00 

2000. 2400. 3600. 4800. 7200. 9AOO. 19200 
DB Si6.7.e 

KBnt 

EOF <0 through 255> (dffcimat) or '<ch«r3 

EOL <0 through 255> IdtciissU or '<char5 

EX cr EXIT 
LI or LIST 

PB EVEN. E. ODD. 0. NONE. H 

SB 1. 1.5. 2 

SI ENABLE. £. DISABLE. D 

SO ENABLE. E. DISABLE. D 

TO <0 through 255> (jttconds) 
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parameter selections. Type 
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Command Structure 

The Set Utility program features a straightforward and flexible 

command structure. After selecting a device, the current settings can be 

listed and changed in any order. 

□ Commands can be entered singly or combined into a multiple 
command line. 

n Both upper- and lower-case entries are accepted. 

o All commands are terminated by (RETURN). 

□ All commands can be automated by command files. 

□ Parameters controlled by the program can be set independently for 
each serial port. 

□ Plain language messages prevent setting parameters improperly 
(out of allowable range, incorrect syntax, unspecified device, etc). 
A table of all messages is given on page 5-26. 
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Syntax Diagram 

The syntax diagram below illustrates the proper syntax for all of the 
commands available in the Set Utility program. 




□ The command line cannot exceed 80 characters (the capacity of 
one line on the screen). If more are needed, use two separate 
command lines. 

o A single command line can be used to set parameters for more than 
one device as long as a comma precedes each device name after the 
first one. 

□ Any number of commands are allowed on the same command line 
as long as each is separated by a comma or space. 
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A port device must be selected before the Set Utility program will 
accept other commands. Device selection can be made a part of the 
single command line. Once the device is selected, subsequent 
commands affect that device until another is specified. 

If a command is entered before specifying a device, the “no device 
specified” message is displayed. 

Attempting to specify a device other than a serial device (KBO: - KB2:, 

GPO: " GPl;, SPO - SP9:) will cause the “illegal device” message to be 
displayed. 




Parameters 




Baud rate is the speed of information transfer. This command changes 
the baud rate of the selected port to that specified by the command 
argument. 



NOTE 

The baud rate of the keyboard and display is 19.2 Kilobaud. 
Setting KBO: to any other baud rate immediately disables both 
the keyboard and the display. This condition can only be 
remedied by pressing RESTART. 




The data bit command sets the number of data bits that will be 
included in each character. 

When character length is set to a value shorter than the actual data‘s 
character length, the lower data bits (least significant) are used. 



If the character length is set to a value higher than the actual data, the 
remaining (most significant) bits are set to zero. 



The following example selects Serial Port 1, and sets the character 
length to 7 bits: 



Parity Bit (PB) 

Parity is a method of error detection that adds an extra bit after the last 
data bit of each word. This bit is set so that the total number of 1-bits in 
each word is always even or odd. The parity command defines a parity 
bit to be generated and checked for the selected port. 




During input, parity is checked as defined by the Set Utility for each 
character. If an error is detected, it is identified to the operating system 
as a device error. This error can only be cleared by closing the channel 
associated with the serial port. 



During output, parity is generated as defined by the Set Utility 
program, and appended to each character. 

In this example Serial Port 2 is selected, and set up to generate and 
check for even parity: 



KB2: PB EVEN (RETURN) 
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Stop Bit (SB) 

The stop bit command defines the number of bit-ceil time periods 
between characters transmitted to external equipment that requires 
additional settling or synchronization time. This command does not 
affect incoming data. 

The following example defines a transmission word spacing of 1 .5 bit- 
cell time periods for Serial Port 1: 

KBl: SB 1.5 (RETURN) 

Stall Characters (SI, SO) 

Stall Input and Stall Output implement the RS-232 X-ON and X-OFF 
capabilities. These two commands tell the transmitter to stop and then 
to resume sending the data. 

Stall Input only affects data being received at the serial port. When it is 
enabled, the Controller sends X-OFF (decimal 19) when its input 
buffer is 3/4 full. When the buffer has been emptied to the 1/4 full 
point, the Controller transmits X-ON (decimal 17). 

Stall Output only affects data being sent from the Controller. When 
Stall Output is enabled, receipt of an X-OFF character causes the 
Controller to suspend transmission until it receives X-ON. 

This sample shows how both Stall Input and Stall Output would be 
enabled for Serial Port 1: 

KBl: SI E, SO E (RETURN) 




The Time Out parameter affects both input and output data. During 
input, if no data is received within the length of time specified by the 
parameter, the Controller resumes processing, rather than waiting 
indefinitely. 

When the 1722A sends data through a serial port, it does so by filling a 
buffer, and creating a path betwen the buffer and the port. If the buffer 
should become full, the Controller waits for the time specified by the 
Time Out parameter. If the buffer has not started to empty by then, the 
attempted data transfer is abandoned. 




continues processing. 



Time Out is specified in seconds (0 to 255). The longest time out, 255 
seconds, equals 4minutes, 1 5 seconds. A time out value of 0 means the 




The terminator commands EOL and EOF define characters that will 
be used to identify the end of a line or file. When received with 
incoming data, a terminator generates an interrupt if enabled by the 
user program. 

EOL only affects data input: All Carriage Return and Line Feed 
characters are deleted, but when the terminator character is received, a 

Carriage Return, Line Feed sequence is appended. (The system does 
not add a second Carriage Return or Line Feed if that character is the 
terminator.) The resulting data is in the internal format of 1 722A data. 






During experimentation, one normally changes the parameters one at 
a time in order to find the correct combination for the device that is to 
be communicating with the Controller. During the development of 
working software, however, it becomes increasingly important to 
begin thinking about how to speed things up. Since any keyboard 
entries can become part of a command file, it is efficient to make one 
entry in the command file set the parameters needed at the RS‘232 
port. 



This example illustrates how all of the above commands could be 
combined into a single command line to change the parameters at a 
serial port: 




Messages from the system are a normal part of operation, and do not 
always signify that an error has been made, though they are generally 
referred to as ”error messages“. Here are the meanings of messages you 
might see from time to time when using the Set Utility program: 

MESSAGE MEANING 

? Argument missing A Command was entered without the 

argument necessary to complete its 
meaning. 



TArgument out of range A Command argument was entered 

which was beyond the range of 
acceptable values. 



?0ad argument A Command argument was entered 

which was not in the list of acceptable 
arguments for that command. 



? 1 1 1 e g a l 



devise 




?No device specified 



A command was entered before 
specifying a device. 



? Unknown command 



A command was entered that was not 
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erial Communications Under Program Control 

To automatically set the parameters of the serial ports, a command file 
must be written that uses Set Utility program commands. The 
parameters cannot be modified by programs written in high level 
languages (BASIC, Fortran). Once the port parameters are established 
by the Command file, however, programs written in any language can 
get information into and out of the port. 



SET 

KBi: BR 2400sDB 7.PB EiSB 1.5>SI EtSO E?TO 15 
EXIT 



The following table illustrates the commands used in the BASIC and 
FORTRAN languages to send and receive information via the serial 
port. Notice that both languages include commands to first open the 
channel, then either to send or recieve data through it. For more 
information, consult the manual that covers the programming 
language you are using. 

ASIC 

To send: To receive: 

OPEN ■■KBI I” AS NEW FILE 1 OPEN KBU AS FILE 1 

PRINT #1, "TESTING” INPUT #1 , A$ 



CALL OPEN (2i 4i 0» lERR) 

WRITE (2» 10) lERR 
10 FORMAT ( ’ERROR C0DE» ’«15) 



READ (2i20) A 
20 FORMAT (F10.4) 

CALL CLOSE (2i lERR) 
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Sample Program 




This sample program shows how these important commands would be 
included in a BASIC language program that reads information from a 
floppy disk in device MFO:, and sends it out to a serial impact printer, 
like the Fluke model 1776A. Some features of the program are: 

□ Prompts the operator for the name of the file to be printed. 

o Handles the most common error: specifying a file that doesn’t 
exist. 

□ Regardless of the size of the file, outputs the entire file, and stops 
when printing is complete. 



10 

20 

30 


! Proarsffl to print s soecified file 
QDIR 




list files 


40 

50 


PRINT 

PRINT 'ENTER FILENAME' 


1 


d 1 sp 1. ay proaia t 


60 


INPUT A* 


E 


filename is variable AS 


70 


IF AS = THEN GOTO 330 


J 


eracef u t e r i t 


80 


<SN ERROR GOTO 220 


1 


error handler 


90 


CLOSE 1 


1 


sake sure channel is closed 


100 


OPEN AS AS FILE 1 


1 


now open i t . 


ilO 


CLOSE 2 


t 


sake sure channel is closed 


120 


OPEN 'KBl E ■ AS NEW FILE 2 


i 


now open it. KBi: is printer 


130 


PRINT «25CHfiS(127.) 


t 


send form feed to arinter 


140 


INPUT LINE til AS 


) 


put one line of file into AS 


150 


PRINT AS 


i 


output the line to orinter 


160 


GOTO 140 


i 


repeat until done 


170 


! 






160 

190 


‘ * Error Handler » 

f ERR (system variabtel = last error 




200 

210 

220 


! - Error 3D5 File Not Found - 

IF ERR = 305 THEN REUUME 230 ELSE 270 




retry if file not found 


230 

240 


PRINT 'FILE NOT FOUND - TRY AGAIN' 
WAIT 1000 \ GOTO 30 


1 


pause i seo) start soain 


250 


! 






260 

270 


1 _ Error 307 End of File - 

IF ERR * 307 THEN RESUME 2S0 ELSE RESUME 


310 ! halt if EOF 


2S0 

290 


PRINT 'TRANSFER COMPLETE' 
CLOSE 1. 2 \ END 




close channels’ halt 


300 

310 

320 


[ 

! - All Other Errors - 

PRINT 'ERROR - CANNOT TRANSFER FILE* 




halt for all other errors 


330 

340 


PRINT 'RETURNING TO BASIC' 
CLOSE 2 




close channels 


350 


END 




halt 
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Leaving out the comment lines, here is a line-by-line explanation of 
how this program operates: 

30 The program begins by doing a quick directory listing to display 
the files that are available for printing. 

40 Puts a blank: line on the screen for readability. 




response to the prompt as 



string variable A. 




Beginning of the error handler. Any error encountered sends the 
program to line 220, where the error type is discovered, and 
various exits are provided depending on the error type. 



90 The CLOSE command is insurance that a previously opened 
channel is closed prior to reopening. To OPEN an already open 
channel is an error; to CLOSE one that hasn’t been opened is not. 
After this ‘insurance’ command, the following line opens the file 
designated as variable A as file 1, for input. 



1 1 0 Again, a command to insure the channel is closed before opening. 




is opened as an 



output. 



The printer (File 2) is sent a Top Of Form command, so that 
printing will start at the beginning of a sheet. 
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140 Each line of the file is input and sent to A$. 

!50 Each line is sent out to #2, the printer. 

160 The return to line 140 gets the next line, so it can be PRINTed by 
line 150. 

220 The error handler begins here. Error 305 is returned if there is no 
file with the name of the one specified as AS. If the error is 305, 
then a message will be displayed at line 230, and allow a retry. 

230 Prints the message that the file was not found. 

240 After a one second wait, goes back to line 30 to display the 
directory again. 

260 The error was not 305, so now it is checked to see if it was 307, the 
End of File. This is the exit when the entire file has been printed. 
All other errors fall through to ending routine that closes the 
channels and stops. 

270 If the EOF was the error, prints the message that the transfer is 
complete. 

280 Closes the previously opened channels, sends the program to the 
END statement to stop. 

300 If the error was neither End of File or File Not Found, then it is 
some other error that makes it impossible to transfer the file. In 
this case, a message is printed, the channels are closed, and the 
program stops. This line could be enhanced by incorporating the 
actual error number for debugging purposes if this program is 
included within some longer one. 

This program illustrates how the important BASIC language 
commands can be used to send data out the Serial port. While it is not 
comprehensive, it does show some good programming techniques. 
(And it works!) 

Before using the RS-232 port, be sure to confirm that the parameters 
specified in the SET Utility program match those of the connected 
device. 
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CONCLUSiON 

This section has described the two ways that the Instrument Controller 
communicates with other pieces of equipment using worldwide 
standard connection and protocol methods. It has also shown how to 
make use of the essential BASIC language commands to send and 
receive information over its instrumentation bus and serial data 
communications bus. 

The next section, Creating and Editing Programs, will show how to 
begin writing your own routines with a view to automating the 
functions of the Instrument Controller. 
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The I722A Instrument Controller is a special purpose computer, and 
like any computer, its instructions must be given in very precise 
language. This section is designed to assist you in the task of writing 
precise instructions. 

There are a number of different facilities for writing and editing 
programs. From Immediate mode BASIC, the command EDIT 
presents a range of possibilities. This is the Editor of choice for 
programs written in BASIC, because it is so well adapted to the task, 
and because it is readily available, once you are “in BASIC”. 



For creating other types of programs, such as Command files or Alias 
files, the System Editor program (filename EDIT.FD2) is easier to get 
at. Also, you will have to use the System Editor if you are 
programming in FORTRAN or some other language that does not 
provide editing functions. 



This section discusses these main topics: 




There are three languages that can be used for programming the 
1722A. Here is a guide to help in selecting the most appropriate 
language for any particular application. 



BASIC is an acronym for Beginners All-Purpose Symbolic Instruction 
Code. The BASIC language is used for about 90% of all programming 
applications because it is fairly common, is easy to learn, and provides 
most of the capabilities that are desired for instrumentation systems. 
There are really two forms of the BASIC language: the normal 
interpreted version, and a special compiled version. 



Interpreted BASIC version is an enhanced version of the BASIC 
language that is common to most computers. It has a built-in editor, 
Immediate Mode Commands, and runs programs interactively. These 
features make program development easy and straightforward, even 
for inexperienced users. Because it is the language of choice for most 
applications, the interpreted version of BASIC is included with every 
1722 A. 



Compiled BASIC is essentially the same language in a compiled form 
to increase its execution speed. Compiled BASIC programs are written 
using the System Editor program. They can be created in a more 
structured form than conventional line-oriented BASIC programs. 
The programs are compiled into a form that runs much faster than an 
equivalent interpreted BASIC program. Compiled BASIC should be 
used in applications where additional speed or a modular structure is 
needed while retaining the familiar BASIC language elements. 
Compiled BASIC is available as an optional accessory software 
package which contains the software required to create and maintain 




FORTRAN is also an acronym. It stands for Formula TransXaXox. 
FORTRAN is a useful language for scientific applications because of 
the ease with which it manipulates numbers. BASIC provides mOvSt of 
the same capabilities, but FORTRAN may be the better choice if many 
of your current programs are already written in FORTRAN, if you are 
experienced in programming in FORTRAN, or if the operation 
requires greater speed. Because it is a compiled language, FORTRAN 
offers high speed, but, like all compiled languages, it is more 
complicated to work with. 



Assembly Language 

Assembly Language provides the programmer with access to all of the 
capabilities of the TMS-99000 processor used in the 1722A. Assembly 
Language programs can usually be both faster and shorter than 
programs written in any other language. In addition, specialized 
Input/ Output and data conversion functions not otherwise available 
sometimes must be written in Assembly. The penalty for this flexibility 
is that Assembly Language programs usually take longer to design, to 
write, and to debug than programs written in higher-level 
programming languages. 



When greater performance is required for a program written in a 
higher-level language it is usually possible to replace time-consuming 
operations with a faster Assembly language subroutine. This can be a 
cost-effective solution if the amount of Assembly code is small 
compared to the total size of the program. 
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It is possible to create, but not edit, programs using the File Utility 
program. To implement this capability, use the File Utility program 
command in the form: 

(filename)=^ KBO: (RETURN) 

Now, any keystrokes made will be filed at the System Device, and given 
the filename specified. The end of the file must be indicated to the File 
Utility program by the command (CTRL) /Z (EOF). 



This facility is not used for creating long or complex programs because 
there is no way to edit them. If an incorrect keystroke is not seen 
immediately, it is necessary to either re-write the entire file, or else use 
an editor program to correct it. 

COMMAND LINE INTERPRETER 

Introduction 

The central program, FDOS, is always present in the system’s memory, 
and its facilities are used by other programs. For example, when a 
program written in BASIC is running, one is tempted to say “a BASIC 
program is running”, but that would be inaccurate because it is actually 
the BASIC Interpreter program that is running. It calls upon the 
Operating System to provide file manipulation and other 
Input/ Output. The execution of a program and the Operating System 
is interleaved. 



In the same way, when the utility programs are in use, they direct the 
activities of FDOS. The Operating System takes control only when: 



1. The utility program requests an I/O operation. 

2. A severe hardware or software error occurs. 

3. The FDOS) prompt is displayed. 

An important feature of the Operating System is its Command Line 
Interpreter. As its name implies, this is the portion of the Operating 
System that accepts keyboard commands and acts on them. It permits 
us to type FUP, for example, and be understood as saying, "Hello, 
Operating System, what I want you to do is go out to the floppy disk 
and find a program called the File Utility program. Read it into 
memory, and pass control of the microcomputer to it.” The File Utility 
program returns control when it receives the Exit command /X. 




When a command line is being written, some rudimentary editing 
functions are available. These features of the Operating System are 
great time savers, because they speed up the creation of Command files 
and access to utility programs. All the commands described are 
available from from FDOS, BASIC, and the TIME, SET and File 
Utility programs. 



These are mnemonically named commands for “Forward” and 
“Reverse”. (CTRL) / R causes the last line entered to be displayed 
again, and repeats until the first command has been reached. When a 
former command has been displayed, it is available for editing, thus 
providing the Controller with an elegant way to avoid much repetitious 
typing. 



Example: 

Since the Controller was turned on, these commands were entered: 



FUP 




03 06 83 
14 35 



The first use of (CTRL) / R would display 14 35, the next 03 06 83, the 
next TIME, then / X, RS232.CMD, and finally FUP. If (RETURN) is 
pressed when any of these are displayed (the cursor can be anywhere on 
the line), the system accepts the commandjust as if it had been typed in. 
If you wanted to get back to the line “RS232.CMD” to run the 
program, rather than having the File Utility program display it, you 
would use (CTRL) /R until the display showed that line, then press 
(RETURN) . If you go all the way back to the line reading “FUP” by 
mistake, just use (CTRD/F to go forward. 

These commands are circular. If (CTRL) /R were pressed once more 
after “FUP” was displayed, the next thing to be displayed would be 
14 35. 




Any time that (CTRD/R or <CTRL>/F are used to display a 
previously entered command, the command can be edited using the 
arrow keys, DEL LINE and DEL CHAR keys, the DELETE key, or 
the backspace (back to left margin), or LINE FEED (to end of line). 
Once the line has been edited, pressing RETURN with the cursor 
anywhere on the line will cause the command to be executed. 

Other editing features of the Command Line Interpreter are: 



operation is in progress, and returns 
control to the Operating System (FDOS ) prompt). 



<CTRL> /C Interrupts an operation, and may abort it depending 
on the operation in progress. 

(DELETE) Deletes the character at the cursor position and 
moves the cursor left one position. This action stops 
at the prompt. 




The Edit program is supplied on the System disk as a file named 
EDIT.FD2. This editor is a visual one, as opposed to “blind” editors. 
That is, the file is displayed as you edit it, 



The Edit program provides a complete set of commands for 
performing these functions: 

□ Inserting Text 

□ Searching, Replacing, and Marking Text 



Positioning the Cursor 
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Entering the Editor Program 

From the FDOS) prompt, type: 

EDIT (RETURN) or EDIT (filename) (RETURN) 

In the first case, no file is specified. If this method is used as the entry to 
the Editor, a filename must be specified later, when exiting the 
program. The reverse is true if a filename is specified as you enter; one 
must not be specified as you exit. If different filenames are given, the 
result would be that two files would be created; the one specified at the 
beginning of the editing session will be empty. 

As always, if no device name is specified, the default is to the System 
Device. 

In this example, the file named FILE. NEW was specified: 

f7— — — — 

I EDITING FILE "FILE. NEW" Cnew f UeD 



If the file already exists, the bracketed “new file” would not be included 
on the display. 

If no file has been specified, only the cursor appears on the top line. 




The rest of the display depends on the file contents, but if the file is 
being created, the display has omega symbols on the left, indicating 
empty lines. 



EDITING FILE "FILE. NEW" 

a 

a 

n 

a 

a 

Q. 



There are some optional flags when entering the editor: 
edit -r [filename] 

Enter the editor and edit the file as “read only”. This is useful for 
viewing a file that you do not wish to change but where using the editor 
is more convenient than using FUP. 

edit -c [filename] 

Starts up the editor in command mode. See the section on operating 
modes for a description of the different modes of the editor. A useful 
system alias would be “e edit -c ?” if you prefer the editor to start up in 
command mode. 

edit -t [device] [filename] 

With this option you can specify which device you want the temporary 
files created with the “:r” command to be written to. If no device 
follows the “-t” flag, then the system device (SYO:) is assumed. See the 
section on the global command “:r” for an explanation of this option. 
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Exiting the Editor Program 

There are several ways to exit the Editor program. The most 

commonly used are: 

□ Entering (CTRL) / C at any time while in the editor writes the file 
and exits the editor. If there is no output file to be written and 
changes have been made to the text in the buffer, a confirmation is 
required to exit the editor. 

□ First record the changed file, then exit the Edit program: 

(ESC) :w (RETURN) write the file 

(ESC) :q (RETURN) exit the Editor 

□ Exit without recording the changes to the file: 

(ESC) :q! (RETURN) 

Other commands permit reading a file into the display while editing 

another file. 
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The Editor has two modes of operation. The Insertion mode is the 
default, and is primarily used for inserting text, although it does allow 
a certain amount of cursor and text manipulation. The Command 
mode is used for more powerful cursor and text manipulation, 
searching, and exiting the program. 

Many Edit program commands result in a temporary return to the 
Insertion mode. When these commands are used, <ESC) is the return 
to Command mode. The purpose of these commands is to save the time 
involved in exiting the Command mode, doing the insertion, then 
returning to Command mode. 



To change from Insertion to Command mode: 
(ESC>:@ (RETURN) 

To change from Command to Insertion mode: 
(RETURN) 



When either change mode command is given, the new operating mode 
becomes the default. 



On the first entry to the Edit program. Insertion mode is the default. If 
Command mode is desired, the EDIT command can be modified by 
using the -c switch. The entire command to enter the Edit program in 
Command mode and begin editing FILE. NEW would read: 



EDIT -c FILE.NEW (RETURN) 
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Global commands operate in either mode. After they are executed, the 
Editor returns to the default mode. They are used to read or write a file, 
and check the status of the Editor. Global commands are always 
preceded by a colon (:). The most commonly used ones are: 

:w Writes the file. 

:q Quits the Editor and returns to the Operating System. 

:q! Quits the Editor without any changes from the current editing 

session. 

:r Reads another file in during editing. 

:s Substitutes one string of characters for another. 

NOTE 

When in the Insertion mode, the Global command prefix is (ESC):. 



Most Used Commands 

The entire command structure of the Editor program contains some 
redundancy; also, some commands are used infrequently enough to 
not require a complete discussion. Most programs can be created and 
edited using only a few of the available commands. The full capabilities 
of the Edit program are presented at the end of this section. 



Cursor Positioning 

In the Insertion mode, the four arrow keys on the six-key auxilliary 
keypad move the cusor in the direction shown by one space or one line. 

In the Command mode, these keys can be preceded by a number to 
move longer distances. For example, 20-^ would move the cursor 20 
places right, and 204 would move it down 20 lines. 

The lower-case letter “w” moves the cursor to the right by one word. If 
a number precedes the “w”, the cursor moves right by the number of 
words specified. 

The lower-case letter “b” moves the cursor back by one word. If a 
number precedes the letter “b”, the cursor moves back by that number 
of words. 
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Text Insertion and Deletion 

In the Insertion mode, any characters typed are displayed and the 
cursor is moved right one position. The <DEL LINE) and <DEL 
CHAR) keys on the auxiliary keypad delete characters or the entire 
line to the right of the cursor without moving the cursor. The 
<DELETE> key (just above <RETURN>) erases single characters to 
the left of the cursor, and moves the cursor left one position. 

In the Command mode, typing the lower-case letter “a'’ returns 
operation to the Insertion mode. Anything typed in strikes over the 
already existing text, but it is displayed again when the (ESC) key is 
pressed. The upper-case letter “A” is a command to add whatever text 
follows, starting at the end of the line the cursor is on. To stop inserting 
text, press (ESC) . 

To delete text in the Command mode, position the cursor anywhere on 
the line and type (CTRL) /U; the entire line is deleted. (DEL CHAR) 
and (DEL LINE) operate just as they do in Insertion mode. If a 
number precedes them, that number of characters or lines to the right 
of or down from the cursor are deleted. Similarly, the (DELETE) key 
can be preceded by a number. For example, the command 
3 (DELETE) deletes three characters to the left of the cursor. 



Substitution 

The substitution (s) command replaces whatever text is to the right of 
the cursor with a specified character. The form is [n]s {char} where [n] 
is the number of characters to be substituted, and {char} is the 
character to be substituted. 

in this example, a time delay of 200 milliseconds was found to be 
inadequate for a program, so the number 200 will be substituted for 
1000. With the cursor positioned under the 2 of 200 the command 
4sl000 changes the 200 to 1000, leaving the cursor at the end of the line. 



60 WAIT 200 



AslOOO 



60 WAIT 1000_ 



All Command mode returns to Insertion mode are terminated by 
(ESC). 




Invisible markers can be placed anywhere in the text from the 
Command mode. There can be 26 such markers in any file, one for each 
lower-case letter in the alphabet. The command ma places a marker 
named “a” at the cursor position. To return to that position after 
subsequent editing, use the command 'a. 



Searching 

Searching can only be done from the Command mode. The Find (F) 
command operates only on the current line, and searches for a 
character to the left of the cursor. The entire command takes the form 
[n]F {char} , where n is a number of occurrences prior to the cursor 
position, and {char} is the character to be searched for. In this example 
of a line from a BASIC language program, the command FI would 
leave the cursor at the line number; 

10 DIM A$ (57.. 57.) 



The second type of search looks for patterns rather than single 
characters. Each of the command characters must be preceded by 
(ESC) . The three command characters that the search command can 
begin with are: 

/ searches forward throughout the buffer. 

? searches backward throughout the buffer. 

! searches forward to the end of the file. 

Whichever character begins the command, search commands always 
take the form [cc] {pat} where cc is the command character, and {pat} 
is the pattern to search for. The pattern searches are repeatable by 
using the lower-case letter n to continue searching in the same 
direction, and the upper-case N to reverse direction of the last search. 
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In this example, the programmer wants to find all those occurrences in 
a program where something is to be printed in normal size letters. The 
cursor is postioned at the end of line 20. The command IPRINT NS 
would first locate the PRINT statement in line 400. The lower-case 
letter n (next) would then locate the next occurance at line 9000. 
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INSERTION MODE COMMAND TABLE 



ACTION 


RESULT 


COMMENTS 


Cursor Positioning 


— ^ 


Move cursor right one 
position. 


Ignored if cursor is at the last 
position on the line. 


t 


Move cursor left one 
position. 


Ignored if cursor is at the left 
margin. 


1 


Move cursor up one line. 


Cursor remains in same 
position on next line unless it 
is shorter: then it goes to the 
end of the line. 




Move cursor down one line. 


Acts the same as 1 


(BACKSPACE) 

or 

<CTRL/H> 


Move cursor to the beginning 
of the line. 


(LINE FEED) 
or 

(CTRL) J 


Move cursor to the iast 
position in the line. 




Deletion Commands 


(DEL CHAR) 
or 

(CTRL D) 


Delete character at the cursor 
position. 


(DELETE) 


Delete character to the left of 
the cursor. 


(DEL LiNE) 
or 

(CTRL E) 


Delete text from the cursor to 
the end of the line. 
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Command Mode 

The Command Mode ofthe System Editor program provides for rapid 
cursor placement, complex searches, deletions, and text marking. It 
includes commands to move sections of a file into a “yank” buffer, so it 
can be placed back into the file at another location. Many commands 
provide a temporary return to the Insertion mode. These commands 
must be terminated by <ESC> to return to the Command mode. 



Each of the lower case letters on the keyboard can be used as a marker. 
Markers are invisible, so if they will be used extensively, it is probably a 
good idea to keep a tally sheet handy to aid in remembering where each 
marker is placed. 

To place a marker named “a” into a file, move the cursor to the desired 
position, then give the command ma. 

Now that marker “a” is in place, you can always return to that spot by a 
search command. The marker is also used with yank buffers and delete 
commands (see below.) 

There is no provision for deleting markers. However, they are not 
recorded with the file and so do not remain after the current editing 
session. Also, the same marker can be moved simply by placing it 
someplace else. The last placement is the one remembered by the 
Editor program. 



A yank buffer is a location in memory available to store information. 
Information is taken from the cursor location to a specified marker. 

The yank buffer is one of the Editor’s more powerful features because it 
can be used to relocate portions of a program as an aid to modifying it. 
For example, if part of a program has inadvertently been left out, and 
to include it requires restructuring the program, use the yank buffer to 
move sections of the program from the screen and into memory, then 
replace them as the new section is written. Another good use for the 
yank buffer is as a holding area for a frequently written line of code, 
such as a tightly formatted PRINT statement or a very long line. 

y'a removes text from the cursor to marker a. 

p puts the buffer back into the text after the character where the 
cursor is positioned. 

P puts the buffer back into the text before the character where the 
cursor is positioned. 
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Search Commands 

Searches can be performed from the cursor position either backwards 
or forwards in a file. The search can be for markers, strings of 
characters, lines or line positions, or to a string that matches a 
metacharacter. 

To search for the first occurrence in a file of the word PRINT, the 
command most commonly used would be: ’PRINT 

Other variations are to use the command characters / and ? to search 
forward and backward on the current page. 

letter n finds the next PRINT statement. 

letter N locates the previous PRINT statement. 



The lower case 




Metacharacters describe patterns of characters that may be more 
complex than words or simple strings of characters. Metacharacters 
are similar to wild cards, but are only used with search commands. 

. (dot) Matches any single character in the line. 

Example: ta.k matches talk, task, and tank, but not 
take. 

^ (caret) Matches at the beginning of a line. 

Example: -^PRINT would locate all the PRINT 
statements in a program, as long as there were no line 
numbers. 



$ (dollar) Matches at the end of a line. 

Example: RESUME 580$ would locate all the lines in 
a program that RESUMES to line 580. 




'pjrint matches both Print and print. 



- (dash) 



With the bracket metacharacter, specifies a range of 
characters (in ASCII order) as a character class. 
Examples: [0-9] matches any single digit. 

[- ~] matches all printable characters 
(ASCII ‘blank’ to tilde) 



Matches any character not in a specified character 
class. 

Example: [!a-zA-Z] matches everthing that is not a 



* (star) The closure character; matches zero- or more 
repetitions of character(s) matched by preceding 
patterns. 

Examples: X* matches zero or more upper-case X’s in 
a row. 

(.*) matches anything between parantheses. 

\ (backslash) The escape operator; causes the character immediately 
following to be treated as a literal character, even if it is 
a metacharacter. 

Example: The pattern \$ matches the dollar sign, not 
the ‘end of line’ metacharacter. matches the backslash 
character. 




Creating And Editing Programs 
Editor Commands 



Command Mode Commands 

The command mode provides complex cursor positioning, pattern 
searches, text replacement, deletion, and insertion. In the section that 
follows, each command is explained, and a five line section of a 
program is used for the examples. The example program lines are 
shown double-spaced to better illustrate the movements involved; in 
actual practice, programs do not allow empty lines as shown here: 



10 DIM A$ (57.* 5%) 

20 TRACE ON 110* AS () 

30 FOR IX = 07 TO 5X 

AO AS <17.1 07.) = CHRS (ASCII (' ’)) + 17. 
50 60SUB 110 



Cursor Positioning 

Moving the Cursor Forward 

Command: [n]-> -or- [n]l -or- [n] (SPACE) 



Purpose: To move the cursor to the right n characters. 



Example: The cursor is at the beginning of line 30. 

The command 12-> moves it to the equals sign: 




0% TO 5% 



Command: 

Purpose: 

Example: 



To move the cursor to column n. 

The cursor is under ‘C of CHRS (column 19) on line 
40. 

The command 38-»-moves it to column 38 (the 1 of 1%). 



AO AS (17.1 OX) » CHRS (ASCII C' ’)) + IX 
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Command 

Purpose: 



Example: 

Example: 

Command: 

Purpose: 

Example: 



[n]w -and- n[W] 

Lower-case: To move the cursor forward on a line the 
specified number of words. 

Upper-case: Operates on strings. 

A word is made up of alphabetic and numeric 
characters, and ends with a space, tab, or punctuation 
mark, or symbols such as $, %, or &. A string can 
include symbols in addition to the alphanumeric 
characters. The cursor is left at the beginning of the 
word or string. 

The cursor is at the beginning of line 30. 

The command 7w leaves the cursor under the word TO: 

30 FOR 17 . = or. TO 57 . 




The cursor is at the left margin of line 30. 
The command 6W moves it to the 5 of 5% 



30 FOR 1% = OX TO 5% 




[n]e -and- [n]E 

Lower-case: To move to the end of the specified word. 
Upper-case: To move to the end of the specified string. 

The cursor is at the beginning of line 30. The command 
2e positions it at the R of FOR. 

30 FOR IX » ox TO 5X 
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Command: 

Purpose: 

Example: 



Command: 

Purpose: 

Example: 



[n] $ -or- [n] (LINEFEED) -or- [n] <CTRL)/J 

To move the cursor forward to the last position of line 
n; the current line if n = 1, or if no number is used. 

The cursor is at the left margin on line 30. 

The command 3$ moves it forward to the end of line 50: 

10 DIM A* (5’yC. 5%) 

20 TRACE ON 110» A« () 

30 FOR IX = 0% TO 5% 

) = CHRS (ASCII ( • ' ) ) + IX 




[n] + -or- [n] (RETURN) -or- [n] (CTRL) /M 

To move the cursor forward to the left margin n lines 
down; if n = 1, the next line down. 

The cursor is at the end of line 20. 

The command 2+ moves it to the beginning of line 40: 

10 DIM A$ (5X» 5X) 

20 TRACE ON 110> A$ O 
30 FOR IX = OX TO 5% 

AQ AS (IXj OX) s= C 




Moving the 
Command: 

Purpose: 

Example: 



Command: 

Purpose: 

Example: 
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Cursor Backward 

[n]b -and- [n]B 

Lower-case: To move the cursor backward to the 
beginning of a specified word. 

Upper-case: To move the cursor backward to the 
beginning of a specified string. 

The cursor is under the R of ‘FOR’ of line 30. 

The command 2b moves it to the 3 of 30: 

30 FOR IX = OX TO 5X 



[nr -or- [n] (BACKSPACE) -or- [n] <CTRL)/H 

To move the cursor from the current position to the left 
margin of the nth line up. If n = I, the cursor moves to 
the left margin of the current line. The current line is 
also used if no number or zero are given. 

The cursor is at the end of line 50. 

The command 3^ moves the cursor to the beginning of 
line 30: 

10 DIM A* <5X» 5%) 

20 TRACE ON llOt AS () 

30 FOR IX = OX TO 57 . 

AS (IXi OX) *= CHRS (ASCII (• ')) + IX 
SOVSOSUB 11D_ 
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Command: 

Purpose: 

Example: 



Command: 

Purpose: 

Example: 



[n] - -or- [n] <RETURN) -or- [n] 

To move to the left margin of the nth line up. 

The cursor is at left margin of line 50. 

The command 2- moves it to the left margin of line 30. 

DIM AS <SXi SX) 

TRACE ON llOi AS () 

FOR IX = OX TO 5% 

AS (IX> OX) = CHRS (ASCII (' ')) + IX 
60SUB 110 




[n]t -or- [n]k 

Moves the cursor up n lines. Attempts to keep cursor 
positioned in the same location on the new line. If the 
target line is shorter, cursor moves to last position. 

The cursor is under the ‘A’ of ASCII in line 40. 

The command 3t moves the cursor to the last position 
of line 10: 



10 


DIM AS (5Xi 5% 


r 




20 


TRACE ON 110» / 


AS () 




30 


FOR IX = OX TO 


5X. 

L 




40 


AS (IXi OX) = 


^RS (ASCII (“ 


' ) ) + IX 



50 



GOSUB 110 
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Moving the Cursor Down 

Command:[n]i -or- [n]j 

Purpose: To move the cursor down n lines. If the cursor cannot 

be kept in the same position because the target line is 
shorter, it will be placed at the last position. 

Example: The cursor is at the last position of line 20. 

The command 2i moves it to the space after CHR$ in 
line 40: 

ID DIM A* (5X» 5X) 

20 TRACE ON 110. AS ()_ 

30 FOR IX * OX TO 5X 
AO AS (IX. OX) * CHRS 
50 QOSUB 110 

Long Cursor Movements 

Moving to the End of the Buffer 

Command: [n]g 

Purpose: To move the cursor to line n of the buffer. If n is not 

specified, the cursor moves to the last line in the buffer. 

Example: Line 50 is the last line in the buffer. No matter where 

the cursor is situated, the command g moves the cursor 
to the beginning of line 50. 




^ASCII ( • ’)) + IX 
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Moving to the End of the File 

Command: 

[n]G 

Purpose: Moves the cursor to the specified line of the current file. 

If not specified, the cursor goes to the last line of the 
file. 



Example: Same as lower-case if the entire file is in the buffer. 



Moving By Screenfuls 

Command: H 



To move the cursor to the top line of the screen. (High) 



To move the cursor to 



the bottom line of the screen. 



Command: [n] (CTRL) /F 



On extremely long files, moves forward by an entire 
screenful (15 lines). The [n] indicates the number of 
screenfuls to go forward. 

The sample program lines are about 80 lines ahead in 
the file. The command 5 (CTRL) /F will position the 
cursor in the general vicinity of the program. (5x 15 75) 



Command: [n](CTRL)/B 

Purpose: To move backwards by screenfuls, as in the prior 

command. 
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Search Commands 

Searching for a Single Character 

Command: [n] f {c} 

Purpose: To move the cursor forward to the nth occurrence of a 

character on the same line. If the character does not 
occur the number of times specified, the command is 
ignored. 

Example: The cursor is at the left margin position on line 40. 

The command 2f$ leaves it under the $ of ‘CHRS’ 



40 A* (IX. 0%) = CHR^ (ASCII C ’)) ^ IX 

Sr'''''GOSTJS~TTtr 



Command: [n] F (cl 



Same as prior command, except searches backwards 
for the character. 



Command: [n] t (c) 

Purpose: Same as [n] f {c} except leaves the cursor at the left of 

the character specified. 



Command: [n] T {c} 

Purpose: Same as [n] f {c} except searches backward, and leaves 

cursor at the right of the specified character. 
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Searching For a Pattern 

Command: / {pat} 

Purpose: Moves the cursor forward to the beginning of the 

specified pattern. The pattern may be anywhere 
between the current position and the end of the buffer. 
If the pattern does not occur, the cursor remains, and 

the message PATTERN NOT FOUND is displayed. 

Example: The cursor is at the first position of line 10. 

The command /5% positions the cursor at the 5 of 5% 
on the same line: 

10 DIM A$ (57.1 57.) 



Command: ?{pat} 

Purpose: Same as prior command, but searches from present 

position backwards to beginning of buffer. 



Command: !{pat} 

Purpose: Same as / (pat) , except searches forward to the end of 

the file. 



Command: n 

Purpose: To find the next occurence of a pattern specified by the 

original /, ?, or ! command. 



Command: N 

Purpose: Same as n(ext), but in opposite direction of the 

original / , ?, or ! search. 
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Marker Commands 

Placing a Marker 

Command: m[x] 

Purpose; To place an invisible marker in the text at the cursor 
position. The [x] must be a lower-case alphabetical 
character. If the same label is used a second time, the 
first one is deleted. All markers are deleted if the file is 
written (w), or when the Editor is quit (q). 

Example: Place a marker named c at the string ‘CHR$’ 

Position the cursor at the ‘C’, and type me. 

Finding a Marker 

Command: '[x] 

Purpose: To find a previously defined marker. If no marker by 

that name exists, the message “Mark not set” is 
displayed. 

Example: The cursor is at the beginning of line 10. 

The command 'c moves the cursor to the previously 
defined marker at ‘CHR$’ on line 40. 

OiM A* (5X. 5%) 

TRACE ON IlOf A« () 
ir. = 07. TO 57. 

(ASCII (• •)) + IX 

50 GOSUB 110 
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Text can only be inserted from the insertion mode. However, for 
convenience, many Command mode commands provide a shortcut 
entry to and return from the Insertion mode. The return to Command 
mode is one keystroke: <ESC> Here are the commands: 

Command: a -or- A 

Purpose: To append text to existing lines. To terminate the 

insertion, use (ESC). If upper-case, first moves the 
cursor to the end of the current line. 

Example: A comment is to be added to line 10. 

Use the upper-case ‘A’ command to position the cursor 
at the end of the line, and enter Insertion mode. 

10 DIM A« (57.1 57.)_ 

Text can now be inserted. Space over and begin the 
comment with an exclamation point. 

10 DIM (10 1 50) ) dimension a 5 by 5 array— 

To terminate the insertion, press (ESC) 

Command: i -or- 1 

Purpose: To insert text at the cursor, moving other text off to the 

right. The upper-case operates the same as lower case, 
but first moves cursor to beginning of current line. 
Terminate the insertion with (ESC). 

Example: In typing line 40, the word ‘ASCII’ was inadvertently 

left out. The remainder of the line is all right. Position 
the cursor at the space between the parantheses and 
type the single letter command i. 

(fO A$ ClXt 07.) » CHR$ (_(• •)> + 17. 

Now type the word ASCII. The result will be: 

40 A$ (IXi OX) = CHR® (ASCII_C ’)) + IX 

Terminate the insertion by typing (ESC) 
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Substitution 

Command: 

Purpose: 

Example: 



Command: 

Purpose: 



Example: 
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[n]s 

The substitute command. The number of characters 
specified are substituted at the cursor. 

The word ASCII is accidentally typed as EBCDIC. 
With the cursor positioned at the A of ASCII, the 
command 6s will substitute EBCDIC for whatever 
characters follow until (ESC) is pressed. The cursor is 
left at the position following the substitution. 

'►O AS CI%i 0%) = CHRS (EBCDIC C ^ ) ) + U. 

The result will read: 

AO AS CIX.OX) = CHRS (ASC1I_(’ ')) + IX 



ricj 

The replacement command allows whatever character 
is at the cursor to be replaced by the specified 
character. This command d&rs from the substitute 
command in not entering the Insertion mode, except 
for the single character replaced. There is no need to 
press (ESC) to return to Command mode (you never 
left it). 

In line 10, the array to be dimensioned was given the 
arguments (7%, 5%). To change the 7 to a 5, position 
the cursor under the 7 and type the command r5. 

10 DIM AS <7Si 5S) 



The result will be: 
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Case Conversion 

Command: [n]'^ 

Purpose; To change the case of a number of characters, either 
upper- to iower-case, or vice versa. 

Example: On line 40, ASCII was mistakenly typed ascii. 

40 A* (IX. 07.) = CHR* (ascii)) +■ 17. 

Position the cursor at the first character, and give the 
command The cursor moves past the inverted text: 

40 AS (IX. 0%) = CHRS (ASCli2> + IX 

Text Deletion Commands 

Small amounts of text can be deleted from the Insertion mode. The 
Command mode expands the possibilities, and permits deletion of text 
in varying amounts. 

Deleting By Character Amounts 

Command: [n] (DEL CHAR) -or- [n]x -or- [n] (CTRL) /D -or- 

[n]s (ESC) 

Purpose: Delete a specified number of characters (not spaces) 

after the cursor. 

Example: In line 20, everything following TRACE ON is to be 

deleted. Position the cursor at the space following 
TRACE ON, and give the command lx. 

20 TRACE ON.llO. AS () 

The new line will read: 

20 TRACE ON^ 
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Command: 

Purpose: 

Command: 

Purpose: 

Command: 

Purpose: 

Command: 

Purpose: 



Example: 



[n] (DELETE) -or- n[X] 

Same as[n]x, except deletes from the cursor backwards. 



M d [-] 

To delete all text from the cursor to the end of the nth 
line prior to the cursor. If n = 1, this command uses the 
cursor line. 



[n] d [$] 



Same as prior command, but deletes from the cursor 
forward. 



[n]s (ESC) 

This command is a special side-effect of the substiution 
command [n]s. It deletes the specified number of 
characters forward from the cursor. A block marker | 
is momentarily visible at the location to be deleted to, 
until (ESC) is pressed. If any keystrokes are made 
before the (ESC) terminator, the characters will write 
over whatever is currently at those positions. See also 
the [n]s substitute command. 

The cursor is on line 40. To delete the word ASCII and 
the space and left paranthesis after it, use the command 
7s (ESC) 

^0 <IX* QX) » CHR» (ASCII (l)> + IX 

The result will be: 

40 Af (IXf DX) = CHRf (-)) + IX 




etion 



Deleting By Line Amounts 

Command: [n]dl -or- [n] <CTRL> / U 

Purpose: Delete the current line, and forward the number of 

lines specified. 

Example: The cursor is in the middle of line iO. 

The command 3dl deletes lines 10, 20, and 30. An 
epsilon symbol is left on the deleted lines: 



€ 

e 

e 



40 A$ ( 1 7. » 07.) = CHR$ (ASCII ( * ’)) + IX 
50 60SU8 110 



'>/’ 



To delete forward from the cursor position to the end 




in the previous example, except that not all of line 
is deleted, the Command 3D results in: 

10 DIM A$ (57.* 5%)„ 

e 

e 



40 AS (17,. 07.) « CHRS (ASCII (' ')) + 17. 
50 SOSUB 110 



Deleting to a Marker 

Command: d‘[x] 



Delete from the cursor foward or backward to the 
specified marker. 
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Control Commands 

Opening a New Line 

Command: o 

Purpose: Opens a line below the cursor line, and switches to 

Insertion mode. Notice that the cursor line is 
momentarily erased, but returns when the screen 
repaints on leaving the Insertion mode <ESC>. 

Example: A line is to be added between lines 10 and 20. Position 

the cursor anywhere on line 10, and press the letter o 
key. 



iO DIH A$ (5X» 5%) 



20 TRACE ON 110» A$ O 



Command: O 



Same as the lower-case command, except the line is 
opened above the cursor. 
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Joining Open Lines 

Command: J 

Purpose: Joins the cursor line to the line below. 

Example: Lines 40 and 50 are to be combined into one line. 

Position the cursor anywhere on line 40, and give the 
command (must be upper case; lower case j is 
equivalent to the down arrow). 

40 AS (17., 07.9 = CHRS (ASCII (' ')) + 17. 

50 SOSUB 110 

The result will be: 

40 AS (17., 07.) = CHRS (ASCII (' ’)) + 17. 50 60SUB 110 

Complete the new line by using <DEL CHAR) to 
remove the line number 50, then separate the two 
statements by a backslash (\). 

40 AS (17., 07.) = CHRS (ASCII)) + IX S 60SUB IID 



Command: (CTRL) /L -or- (CTRL) /R 

Purpose: These commands eliminate unused lines by repainting 

the screen. Any epsilon characters that have been 
generated during an editing session will be dropped. 



Translating Upper and Lower Case 

Command: (CTRL) /A 

Purpose: This command is a toggle that maps upper case to 

lower case and vice versa. It is only active in the 
Insertion mode, and can be helpful for editing 
FORTRAN programs or others that must be all upper- 
case. It allows one to enter lower-case commands (most 
of the Edit program’s commands are lower-case) while 
entering upper case text. 
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Target Commands 

Target commands have two parts, the command itself and a “target” 
that specifies the extent of the command. The command determines 
the action to be taken, such as deleting or yanking. The target specifies 
the direction and number of characters that the action will be 
performed on. Targets are the same cursor motions that were 
presented earlier, “w” for word, for example. The user can delete a 
word of text by the command “dw”. The “w” specifies that the deletion 
will take place over a cursor motion of one word to the right. 

By entering the command twice for the “d” and “c” commands, the 
action will take place on the entire line. For example, the command 
“4dd” would delete four lines of text. 

The table below explains the three Target commands: 

Change text from cursor to [n]c {target} 
target (Enters Insertion mode: 
terminate with (ESO). 



Delete from cursor to target. 




The table below shows each of the Targets, and indicates the cursor 
movement for each of them: 



CURSOR MOVEMENT 


TARGET 


Left margin of current line. 


A 


Last character of current line. 


s 


One space to the right. 


<SPACE> 


To specified column. 


[n]i 


Forward to the nth occurrence of c. 


f{c} 


Forward to the character prior to 
the nth occurrence of c. 


F{c| 


Forward to the character after the 
nth occurrence of c. 


t{c} 


Back to the character after the 
nth occurence of c. 


T{c) 


Beginning of next word. 


w 


Beginning of next string. 


W 


End of next word. 


e 


End of next string. 


E 


Beginning of previous word. 


b 


Beginning of previous string. 


B 


To a marker. 


'[mark] 
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Global Commands 

Global commands are available from either the Insertion or the 
Command mode. They perform these functions: 

□ Read from files into the buffer. 

□ Write from the buffer into a file. 

□ Page through a file. 

□ Toggle the default mode. 

° Check amount of available memory space. 

□ Display the software version. 




Global Commands 



Before using any of the Global commands, be sure you are familiar 
with these terms: 




File: A complete package of 
information, either data or a program, 
recorded in a file-structured device. 
The file may be shorter or longer than 
the buffer, but is generally longer. If it 
is longer, that portion that doesn’t fit is 
retained on the disk. 



Buffer: An area of memory that the file 
is brought into for editing. Notice that 
the buffer may not be large enough to 
contain the entire file. This is 
important, because some of the global 
commands assist you in manipulating 
portions of the file in and out of the 
buffer. 

Screen: The 15 lines of the buffer that 
are displayed at any given time. 
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Editing an 


Existing File 




Command: 


:e {filename.ext} 




Purpose: 


Reads the named file and opens a temporary file where 
changes will be recorded. If there is no file by the name 
specified, a message is displayed. This command is 
equivalent to exiting the Edit program, and reentering 
it from FDOS with the command EDIT {filename} . 




Example: 


Work has been finished on one file, and you wish to 
save it and edit another. File the first one, but do not 
exit the Edit program. To do this, use the Global 
command :w to record the first file, then the :e 






{filename} command to begin editing the next. 




Command: 


:e! {filename.ext} 




Purpose: 


Discards any changes to file being currently edited, 
then begins editing the named file. This command is 
equivalent to using the :q! command to exit the editor 
without changing the file, and re-entering it from 
FDOS with the EDIT {filename} command. 




Example: 


During editing, it is discovered that the wrong file is 
being corrected. To exit without incorporating any 
changes, but stay in the Edit program, re-file the first 
program, and use the :e! {filename} command to bring 
in the second. 




Paging Through a File 




Command: 






Purpose: 


Writes out the current contents of a buffer into the 
output file, then loads the next page into the buffer, 
displaying the first 15 lines. This command is 
equivalent to :w followed by :r (see next page). 
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The commands for reading in another file require temporary files to be 
created. If the -t option is not specified on the command line then the 
temporary files will be created on the same device as the input file. 
Sometimes there is no room for the temporary files and the output file 
on the same device. It then becomes convenient to use the ~t option to 
specify another device. For example, say you are editing a file on the 
floppy disk and it is the default system device, S YO:. You know you will 
be merging some other files into this file using the :r command. You 
might want to start up the editor with the command: 

edit -tedO: file.bas 

This command instructs the editor to create the files needed for the :r 
command on the device EDO:. This allows the largest amount of disk 
space to be allocated on the system device for the output of the updated 
copy of the input file. A temporary file created by a single :r command 
will never exceed 50 blocks in size. Even in systems without extra 
memory installed, the E-disk (device EDO:) is a convenient device for 
creating the temporary files. 



Command: 



:r 



{filename} 



Example: A subroutine has already been developed, 

debugged, and incorporated into a file named 
ACDC.BAS. It has been found to have application 
within another program currently being developed. 
While creating the new file (call it SYNCH. BAS, for 
example), read in ACDC using the :r command, and 
delete everything except the desired subroutine,. Now 
write the new file using the :w command. 




Command: 

Purpose: 

Example: 

Command: 

Purpose: 

Example: 
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:R {filename) 

Same as the lower-case :r command, except that :p will 
work without creating a temporary file. 

A program is being created, and it is thought that a 
particular subroutine can be incorporated. Use the :R 
command to bring the file to the buffer. This command 
allows you to page through the file without modifying 
it. 



:r -or- :R 

Read from the current input file, inserting text at the 
current cursor position. These commands are the same 
as the other :r commands, except that no filename is 
specified, so the file currently being edited is used. 



A program in development has been designed with 
cascaded loops, or with many repetitive lines of code. 
Write the module to a file, then use the :r command to 
repetitiously read it back to the screen. 
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f ) 


Substituting 


Patterns of Text 


Command: 


:s/ {oldpat} / {newpat} / 




Purpose: 


Substitute one pattern for another. The patterns may 
be words, strings, or expressions. The substitution 
begins at the current cursor position, and continues to 
the end of the buffer. 




Example: 


During program development, it became necessary to 
renumber the starting line of a subroutine. All GOSUB 
statements must be changed to reflect the new line 
number. If the old line number was 1040, and the new 
line number is 1060, use the command: 




Command: 


:S/ {oldpat} / (newpat) / 


i - 


Purpose: 


Same as the lower case example, except that this 
command operates on the entire file, notjust the buffer 
contents. 


/■ 


Writing From the Buffer into a File 




Command: 


:w {filename} 




Purpose: 


Writes the contents of the buffer to the named file. If 
the output file is the same as the the current input file, it 
is not necessary to specify a filename. This is the 
normal command to record a new or revised program 
to a file, either prior to exiting or before reading (see :r) 
a new file to the buffer for editing. 


5 
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Toggling 

Command: 

Purpose: 



Example: 



Checking 

Command: 

Purpose: 

Example: 
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This command changes the default mode between 
Insertion and Command modes. Use the Insertion 
mode for most normal keyboard entries of programs, 
and light editing, like deletions and small cursor 
movements. Use the Command mode for large 
movements, searches, replacements, marking text, and 
other more complicated editing. 

To switch to Insertion mode from Command mode: 
:@ (RETURN) -or- :@ (ESC) 

To switch to Command mode from Insertion mode: 
<ESC):(5) (RETURN) -or- (ESC):(a) (ESC) 



:m 



Displays the size of the text in the uuffer, the amount of 
text in the yank buffer, and the amount of memory 
space still available. The information is displayed on 
the top line of the screen, and is given in bytes. 

During an editing session in which a long program has 
been entered, it is desired to check the amount of 
memory remaining before continuing. If the text size is 
approaching the size of the memory remaining, it may 
be necessary to either clear the yank buffer before 
proceeding (see the Command mode command Y). The 
other alternative is to write the current buffer to the 
file, then continue (see the Global command :w). 
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When the :m command is given, the top line of the 
display shows: 



Teit s1z9! A37i Yank slzet 0* Soace renainingt 36392 



This display would indicate that only 437 bytes of the 
buffer are in use, the yank buffer is clear, and that 
nearly 37 Kbytes of buffer space is still available. 




Command: :v 



Purpose: To check the Edit program version. This is not used 

during normal Editing, but can be checked if needed as 
an aid to tracking down a problem that is suspected to 
be due to software incompatibility. 



Exit to the Operating System 

Command: :q 

Purpose: Returns to the Operating System when an editing 

session is complete. 



Command: :q! 

Purpose: Same as the normal quit command, except that no 

changes are recorded to the file. 

Example: During an editing session, some changes have been 

made to the wrong program, and the revision would be 
catastrophic if implemented, but would be a major 
effort to correct. Use the :q! command to return to the 
Operating System. Now the File Utility program can 
be used to locate the correct program. If the filename of 
the correct program is known, use the :e! {filename} 
command. (See Editing an Existing Program, above.) 




The System Editor 



rogram messages 

Because of the many commands and options that the Edit program 
provides, it is likely that some error messages will occur during editing 
sessions. The list below explains what each of the messages means, and 
is a guide to corrective actions. 



MESSAGE 



MEANING 



A mark name was given that is not a 
lower-case alphabetic character. 

A mark was specified that has not 
yet been assigned. 



1 ttva ltd t araet 



The command does not exist, or has 
been entered incorrectly. Insure that 
the command is constructed 



Illegal substitution syntai 



Inva lid t arget 




CaA't opfft nvM ouipui 
during 'a'dtt 




The substitution command was ill- 
formed in some way. Can be caused 
by an improper character or added 
spaces in the command. 

A Target command has been given 
for a target that does not exist. 
Check that the target is available, 
and that the command has been 
constructed properly. 

An attempt was made to put onto 
the screen the contents of an already 
empty yank buffer. 

An attempt was made to record the 
buffer to a file other than the input 
file. 

Either the media is write protected 
or the directory is full. 
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MESSAGE 




■'No |jr«y'TotJS' 



MEANING 

A new file is being created, but no 
name was specified when the editing 
session was started. To write out the 
buffer to a file, you must specify a 
filename using the :w or :q 
commands. 

A next pattern command ( <ESC) N) 
was attempted when no pattern was 
first searched for. 

The disk drive door was opened, and 
the floppy disk removed during 
editing. 




CONCLUSION 

This section has described how to use the System Editor program as a 
tool for creating and modifying programs. While the descriptions are 
accurate and complete, the best way to become familiar with the Edit 
program is to actually use it. This section can be used as a guide while 
you are trying out the various commands, and will be a useful reference 
as you gain experience. 

The next section shows how to use the various tools available to 
automate the functions of the 1722A Instrument Controller. 
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INTRODUCTION 

The power of the 1722A Instrument Controller is a direct function of 
its programmability. This section describes how to program the 
Controller to perform its various functions automatically. The major 
topics in this section are: 

Command Files 

Establishing an Environment - the BASIC SET SHELL Statement 
Alias File 

Automating Utility Programs 
Sample Instrumentation System 
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MNP FILES 

The Operating System recognizes the contents of any file with the 
extension .CMD as a string of ASCII characters (keyboard 
commands) to the Command Line Interpreter. This feature provides 
an advantage to the user by allowing a series of keyboard entries, such 
as those required by a utility program, to be stored as a file. When such 
a file is active, it can control the utility program without requiring a 
long string of keyboard entries each time it is used. 

In the following example a command file has been written that presets 
Port 1 to a state required by a printer connected there. The file is called 
SETPRT.CMD and is created from FDOS using the edit command. 
All of the Set Utility commands used in this example are defined in 
Section 5, and the edit program is described in Section 6. 




Any time the command file is active it can be aborted by (CTRL) /C, 
or by pressing the front-panel ABORT switch. The message 
“Command file aborted” is displayed, and control of the system 
returns to the shell program. 



NOTE 

Some programs, like TIM Band TCOP Y, present a special case 
when they are used as the last line in a command file. Since they 
generally require user input, it is necessary to end the command 
file with a blank line if they are the last command in the 
command file. 
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Special Characters 

Certain characters take on a new meaning when they occur in a 

command file. This section explains each of these characters, and then 

gives an example of a command line using these special characters. 

! Substituted by a line entered from the keyboard. Using an 
exclamation point permits the creation of interactive 
command files. When an exclamation point occurs in a 
command file, later commands are not acted on until the 
(RETURN) that terminates the input. 

& Causes the line immediately following to be displayed, until a 
(RETURN) , tilde, or exclamation point. An exclamation 
point or tilde can be put on the displayed line to cancel the 
display without a (RETURN ) . In this way, the Command file 
can be made to wait for operator input before proceeding. 

{ } Any characters between braces is displayed. If the left brace 
does not have a matching right brace, everything after the left 
one will be displayed. These characters are used to display 
portions of the Command file to allow easy debugging. 

? A metacharacter that is substituted by an argument passed to 
the command file either from the keyboard or another 
command file. 

$ A metacharacter that is followed by a single digit (0-9), to be 
substituted by a portion of the argument passed to the 
command file either from the keyboard or another command 
file. A portion is defined as a string of characters between the 
space and end-of-line delimiters. $0 returns the name of the 
command file (to invoke it repetitiously); $1 returns the first 
portion of the argument, $2, the second, and so on. If no digit 
follows the dollar sign, it is passed through unchanged. 

~ The tilde clears any previous entry from the Touch-Sensitive 
Display, and waits for the screen to be touched. Command files 
cannot decode the location where the screen was touched. 
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The backslash is the escape operator. Any character following 
it is interpreted literally. &\ $5.00, for example, displays as 
$5.00. There are two special cases of this character: 

\e 

converts to <ESC> 

\b 

converts to (BEL) 



Sample Command Line 

Assume this command line occured in a Command file: 

fcNeCB) 22H\»C5mT0UCH\»Clm SCREEN TO CONTINUE\b\®E:m*‘Thank You. 

The meaning of this line is: 

Print at cursor position 8,22 (line 8, position 22), the word “TOUCH” 

blinking (escape 5m), and print “SCREEN TO CONTINUE” in high 
intensity (escape 1 m), sound a tone ( \ b), and wait for the screen to be 
touched (~). When the screen is touched, print, “Thank You” on the 
same line. 
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The file named STRTUP.CMD runs automatically whenever the 
system is powered up. Like all Command files, the Startup file can be 
run by typing its name from the FDOS> prompt; the extension is 
unneccesary. The special thing about the Startup Command file is that 
the Operating System looks for this file whenever the yControiler is 
powered up or reset. 

There are two major results of this feature. First, it allows the intial 
setup and configuration of the 1722A to be preprogrammed; and 
second, it permits the keyboard to be disconnected from the Controller 
once the programs have been developed to the point that they run 
properly without it. 

NOTE 

While developing the Startup Command file, do not 
name it STRTUP. CMD until it has been tested as a 
Command file with some other name. If there is a 
problem, e.g., an unending loop is inadvertently 
created, it is much easier to correct the error if it only 
occurs when the file is intentionally run, rather than 
every time the Controller is turned on. 
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Assume that a Startup Command file looks like this: 

SET 

KBl: BR600, PB E, TO 30 
EXIT 

TEST1.CMD 

BASIC 

RUN “RS232.SEL” 

This Command file would begin by running the Set RS-232 Utility 
program, establish the baud rate, parity bit, and time out parameters 
for port KBl:. Then it exits the Utility program and performs the 
keyboard commands contained in TEST1.CMD, another Command 
file. When TESTl is complete (whatever it might be), control reverts to 
the Startup Command file, which loads the BASIC Interpreter and 
runs the program RS232.SEL. 

Notice that the Command file can bring in another Command file. It is 
possible, for example, forTESTl.CMD to call still another Command 
file, say TEST2.CMD. Up to four of these branches are possible. If the 
fourth Command file calls still a fifth, the first is lost, and any 
subsequent commands that it contains will not be executed. 

Assume that the program named RS232.SEL is a BASIC language 
program that presents test selections to the operator. By using the 
BASIC statement SET SHELL, a program can be designed that 
returns to RS232.SEL when the ABORT button is pressed. Otherwise, 
the system would return to FDOS, which provides no possibility for 
operator input other than RESTART, ABORT, or both (a cold start). 
None of these is of much value, since it means that the test must start 
again from the beginning, loading the Operating System and the 
Startup Command file. 
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Part of the power of the 1722A Instrument Controller is the 
opportunity it affords the programmer to completely structure a 
programming environment. This capability is a result of the Fluke 
Enhanced BASIC language statement SET SHELL. 

The SET SHELL statement is covered in detail in the BASIC 
Programming Manual, but deserves mention here because it is so 
intimately connected with programming the Controller. 

Assume the Startup Command file has these lines: 

BASIC 

SET SHELL“MFO:BASIC” 

RUN “PROGl” 

RUN “PROG2” 

On power up, this Command file loads the BASIC interpreter 
program, and sets the system to a BASIC Environment. Next, it loads 
and runs a BASIC language program called PROGl. No matter what 
happens during execution of PROGl, including a “fatal error”, 
recovery can be made by pressing the ABORT button. The result is 
that PROG2 would be immediately executed. Upon completion, or 
when the ABORT button is again pressed, the SET SHELL statement 
returns control to the BASIC Interpreter program. This is what is 
meant by establishing the BASIC environment, and is in fact a 
variation of what the Getting Started disk does. 

The Immediate mode BASIC statement SET SHELL (with no 
arguments) resets the shell to the Operating System. Notice, however, 
that when the BASIC Interpreter program executes this statement, it 
does not immediately return to the FDOS) prompt, but to the BASIC 
Ready prompt. Now, the EXIT command can be used to return to the 
Operating System. When the shell is set to BASIC, any EXIT 
commands merely exit the current program, and return you to the 
BASIC shell, just like pressing RESTART. 

Be careful not to use commands like “SET SHELL TIME”. Doing so 
will set the environment to the Time and Date Utility program, which 
will continually ask you the time of day, rather than doing anything 
productive. 



7-8 




Automating System Functions 
The Alias Files 



ALIAS FILE 

An alias, as the name implies, is a way to call something by a different 
name. The purpose of an alias is to provide another programming 
shortcut to help simplify the creation of programs for the I722A. 

During programming, you may want to shorten repeatedly used 
commands (or command lines) by using an alias. Aliases are recorded 
on the System disk in a file called ALIAS. SYS. The standard aliases 
provided with the Controller can be seen easily by displaying this file. 
You can use the System Editor program to add your own aliases or to 
modify the standard ones. 

Aliases provide another powerful feature of the Command Line 
interpreter. By observing which commands are being entered 
repetitiously, a collection of shortened commnds can be created and 
recorded in the file named ALIAS. SYS. The alias file is part of the 
system software, and its contents become a part of the vocabulary of 
the Command Line Interpreter during software loading. Since this is 
true, aliases can be used within the Startup Command file, which does 
not become active until after the software is loaded. 

Aliases are operational whenever the FDOS> prompt is displayed. 
They can only be used from the FDOS Command Line Interpreter. 



Creating Aliases 

By adding to the system alias file (ALIAS. SYS), you will be able to 
abbreviate many commonly used commands into a single keystroke or 
a short sequence of keystrokes. Be certain to observe the correct 
syntax. Here is the required syntax for constructing an alias: 



key(s) 




command 














The command may contain the following metacharacters: 
□ Use the $ character to pass multiple arguments. 

D Use the ? character to pass a single argument line. 
According to the required syntax, the alias 



translates into: FUP pathname2 = pathnamel (a useful copy alias). 
When the alias is used, the syntax is: 




□ If the alias takes arguments, then each argument must be separated 
by a space. 



According to this syntax, to use the copy alias in the previous example, 
you would type: 



to copy the contents of FILEl to FILE2. 

□ The alphabetic case of an alias is significant, allowing you to use, 
for example, D to delete files without using the Interactive switch, 
and d to delete them but asking for confirmation first. 

□ If the ? or $ characters are used to pass arguments, they can accept 
any character as the argument. 
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rror Messages 

During software loading, error messages indicate if the alias file is too 
long, or if an I/O error occurs during the time that the alias table is 
being built. In either case, the table is valid up to the point of the error. 
The error messages are: 

MESSAGE MEANING 

?AJias #i!e too long Alias file longer than 400 

characters 

?unabie to read alias file Data in alias file is either 

corrupted or is non-existent. 



If the file ALIAS. SYS is displayed, it will look like this: 



dir 
qd Ir 
»d i r 
protect 
unprotect 
pac k 
kill 
list 



fup 7/1 
f up ?/q 

f up ? /« 
fup ?/+ 
■Pup ?/- 
fup "^/b 
■P up 



Pup 

f up al i<i 



Each short expression on the left can be used instead of the longer 
expression on the right. These standard aliases shorten often-used File 
Utility program commands into brief, easily remembered keystroke 
sequences. 
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Each of the aliases supplied on the System disk are explained here. The 
form of the alias indicates how it is used, and the equivalent shows the 
keystrokes that would normally have to be entered instead of the alias. 

f Form: f {command} Equivalent: FUP 

(command) 

IX 

The first alias, f, uses the ? metacharacter as an argument to the 
command fup, so that the effect of the alias is to enter the File Utility 
program, perform the FUP command indicated, and return to FDOS. 
If there is no argument, the metacharacter acts as a (RETURN) , and 
the effect is simply to enter the File Utility program. 

dir Form: dir {pathname} Equivalent; FUP 

{pathname} / L 
/X 



Enters the File Utility program and lists the contents of a device that is 
indicated by the ? metacharacter. 

qdir Form: qdir {pathname} Equivalent: FUP 




The most frequently used directory listing command, this alias is the 
same as dir, except does the Quick Listing of the named device. Use the 
* wildcard in the filename field to list only the files with the desired 
extension, or in the extension field to find all the files with a given 
filename. Note that wildcards are not allowed in the device field. 

edir Form: edir {device} Equivalent: FUP 

(device) /E 

IX 

Yields the Extended Directory listing of the named device. 

pack Form: pack (device) Equivalent; FUP 

(device) /P 

IX 

Packs the named device to remove (not used) and (temp ent) entries 
to make more room in the directory. 
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protect Form: protect {pathname} Equivalent: FUP 

{pathname} / + 
/X 

Protects the named files. Use wild cards and the defaults to extend the 
capabilities of this alias. 

unproteci Form: unprotect {pathname} Equivalent: 

FUP 

{pathname} / - 

Removes the protection of the named files. 

kill Form: kill {pathname} Equivalent: FUP 

{pathname} /DI 
/X 

Enters the File Utility program, and uses the ? metacharacter to delete 
the named file. Notice that the Interactive switch is used to be certain 
that confirmation is requested for each file to be deleted. In aliases of 
this sort, it is important to make use of the Interactive switch, because 
otherwise, kill *.* would delete all unprotected files without the “really 
delete...?” message. 

list Form: list {filename} Equivalent: FUP 

KBO:={filename} 

/X 

Enters File Utility, and uses the ? metacharacter to display a named 
file. 

assign Form: assign {device} Equivalent: FUP 

{device} / a 

Enters File Utility, and assigns as SYO: (the System device) the device 
that matches the ? metacharacter. 
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copy Form: copy {source} {destination} Equivalent: FUP 

{filel=file2} 

/X 

This copy alias accepts two arguments: $2 is the source device:file.ext, 
and $1 is the destination. To use this alias to copy a file called 
TEST.BAS from MFO: to EDO:, the construct would be: 

COPY MFO;TEST.BAS EDO: {RETURN) 

Notice that this alias contains an ingenious method of getting around 
the normal system requirement of first specifying the destination and 
then the source. The technique used in this alias will probably interest 
you if you have experience in systems that require specifying the source 
before the destination. 

? Form: ? Equivalent: FUP 

ALIAS.SYS 

/X 



This alias displays the file which holds its own definition. 



This alias saves keystrokes, and simply loads the BASIC Interpreter 
program. 



e EDIT ? 

Loads the System Editor program, and displays the first lines of the 
specified file. 

s SET 

This alias provides a single-keystroke access to the SET Utility 
program. 
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t TIME 

This alias provides a single-keystroke access to the Time and Date 
Utiltiy program. 
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When a new 1 722A arrives, one of the first things that is normally done 
is to use the Time and Date Utility program to set the internal clock. 
This clock can later be used by programs to perform an activity at a 
specified time, or to report the time when a condition was met or when 
a piece of data was gathered. 

The Time and Date Utility is a machine-language program supplied on 
the System Disk with the file name TIME.FD2. When TIME.FD2 is 
loaded into memory, it requests the user to set the time and date of the 
internal time clock. (See section 3, Software Configuration, for details 
about how to set the time and date.) When called from an active 
command file, the Time and Date Utility program does not request 
input unless status shows that the clock has lost power since the last 
time it was set. 



Using the Time and Date Clock 

The command language of the Controller permits command files to 
use the Time and Date Utility program. The TIME command can be 
modified by the arguments -P, -T, and -F. 

TIME -P Prints the current setting of the clock. 

TIME -T Allows the clock to be set from the Touch-Sensitive 

display. 

TIME -F Forces the clock to display the current settings and wait 
for input, just as if the clock had not been previously set. 

Any combination of the arguments can be used. For example, this line 
in a command file: 

TIME -T -F 

would display the current setting, and request operator input from the 
Touch-Sensitive display. 

If TIME is called as the last command in a command file, it must be 
followed by a blank line. Otherwise, TIME will always request user 
input to set the time whether or not the clock has lost power since the 
last time it was set. 
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Programming Language Commands 

Each programming language available for use with the Controller 
provides commands that can be used to read out the time and date. The 
table below is a synopsis of these commands. For more information, 
refer to the individual programming manuals. 



BASIC 



TIMES Returns the actual time of day. 



STIMES 


Same as TIMES, but includes seconds. 


TIME 


Indicates in scientific notation the number of milliseconds 
since the previous midnight. 


DATES 


Returns the actual date. 


FORTRAN 




TIME 


Returns the number of milliseconds since the previous 
midnight as a long integer (INTEGER *4). 


DATE 


Returns the date as an integer in a 16-bit format. 


ATIME 


The current time as an ASCII string in 24 hour format 
(hh:mm:ss). 


ADATE 


Current date as a 10-byte ASCII string (dd-Mmm-yy). 


ITIME 


Returns the current time as an array of three integers in 24 
hour format. (hh:mm:ss). 


IDATE 


Returns the current date as an array of three integers 
(dd mm yy). 




Automating System Functions 
Automating Utilities 



Set Utility Program 

Not all of the functions in the Set Utility program are available as 
programming language commands, so if you need to change any of the 
port parameters under program control, you can use a command file. 
Once a program determines which port parameters have to be changed 
and what the appropriate value of each parameter should be, the 
program can write this information out to a new command file and 
execute it. 

For example, if a running program has found that the baud rate at 
KBl: should be set to 19,200, the following BASIC program lines 
would create and run a command file to accomplish this; 



1 


1 


! printer ! 


10 


OPEN ' 


'PRNTST.CMD' AS NEW FILE 


20 


PRINT 


»1. 


'SET' 


30 


PRINT 


#1. 


'KBl; BR 1 9200 ' 


40 


PRINT 


# 1 > 


'EX ' 


50 


PRINT 




'BASIC' 


60 


PRINT 




'RUN MYPROO' 


70 


CLOSE 


#1 




SO 


EXEC 


'PRNTST' 



NOTE 

Take some care when using this method of changing port 
characteristics if simultaneously using the SET SHELL 
function. If a different shell has been set, it then becomes the 
job of that shell to interpret all of the commands in an 
executing command file. 



File Utility Program 

Like the Set Utility program, not all of the functions of the File Utility 
program are available as programming language commands. The 
method described above can also be used for automating File Utilities 
from a program. 
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In this section, the sample instrumentation system first introduced in 
sections 2 and 5 is used once again. In section 2, the sample system was 
used to introduce how a system would be physically configured and 
tested. Section 5 used it to demonstrate programming techniques using 
both RS-232 and IEEE-488 communications. In this section, the 
sample system is used to demonstrate how a complete program for an 
instrumentation system would be developed. 




RS-232 Port: IEEE-488 Instrumentation Bus: 

I776B Serial Impact Printer 1722A Instrument Controller 



6071 A Frequency Synthesizer 

I953B Frequency Counter 
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The Unit Under Test is the undefined subject instrument. It doesn’t 
matter what the UUT is; by its connection we can assume that it will 
respond to a varying input frequency by varying its output frequency. 
The Frequency Synthesizer is going to send a signal at some frequency, 
and the Frequency Counter will read the result, sending it back to the 
Controller. 

One other instrument is connected in the sample system: the 1776B 
Serial Impact printer. In this example, the printer will be used to give a 
hardcopy of the test results. The printer, of course, is not necessary for 
system operation, but is included to fill out the example program we 
will be developing. 
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Step 1: Start With a Flowchart 

Developing a flowchart is a necessary part of developing software; 
unfortunately, it is often not done because it sounds like an easy task to 
string together a few lines of code and get some kind of meaningful 
result. However, there are several good reasons to write a flowchart 
before writing a program: 

□ First, with a flowchart to guide your efforts, you will write more 
efficient programs, and be less likely to get sidetracked. 

□ Second, program debugging can be greatly simplified if a flowchart 
is available that shows what the program is supposed to do. 

□ Third, the flowchart provides a valuable piece of documentation if 
you want to modify or use parts of the program later. 

□ Fourth, the flowchart will help others understand and/ or modify 
your program. 



The flowchart is a graphical representation of how the program will 
proceed. It translates an algorithm into a visual aid, so that the 
interactions among the various parts of the program can easily be seen. 
It also provides a valuable first step in the programming task, because 
it breaks the job down into manageable modules, each of which can be 
written in order, and then linked together. 
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The flowchart for the sample instrumentation system might look 
something like this: 
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As program development progresses, update the flowchart to 
incorporate new ideas and program capabilitites. While the example 
program was being written, four flowcharts were drawn, each one 
showing slightly more refinement and detail. 

When the program was complete, a final flowchart was drawn to show 
how the actual program worked. The first flowchart can be thought of 
simply as a guide for program writing, and the final flowchart as a 
document that shows how the program operates. 

The final flowchart for the sample is shown on the next page. 
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Step 2: Establish Bus Addresses 

The next step in developing a program for this system will be to 
establish the addresses of all the IEEE-488 instruments. All Fluke 
instruments are set by rear-panel switches, and usually conform to an 
easily-remembered scheme. In both the Synthesizer and Counter of 
this example, the address switches are binary-weighted; the manual 
provided with the instrument gives complete details on how to set its 
address. 

in the sample system, bus addresses are set up as follows: 

01 Frequency Synthesizer 

02 Frequency Counter 



Programming even this simple system can be too complex without 
proper planning. Be judicious; program by parts, then link the parts 
together. In this example, follow the flowchart to program the various 
modules. 



Setup Module 

The Setup Module starts the program by establishing variables and 
strings that will be used later. This module is sometimes thought of as 
“housekeeping”. Here are some of the things that such a module can be 
used for: 

□ Establish the location of the error handler routine. 

o Assign the name of the array that will hold the test data. 

□ Assign escape sequences as variables to saving typing later in the 
program. 

□ Link to an object file, so that there is no need to access the disk later 
when the file is used. 

□ Define subroutines that will be used throughout the program. This 
program will use such a subroutine to draw the operator selection 
boxes using the graphics plane. 
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First Screen 

For most programs, it is a good practice to incorporate an 
introductory screen to identify the program to the operator, and to ask 
for the screen to be touched when the test setup is ready. This insures 
that the correct disk is loaded, and gives the operator confidence that 
everything is under control. 



This module is the first selection screen, and will do these things: 

□ Present the range selections available. 

□ Provide an exit selection in case the operator notices that the 
wrong program has been loaded, or for some other reason wants to 
quit testing when this screen is displayed. 

□ Accept the selection, and use it to: 1) Address the Synthesizer as a 
listener, 2) put it into remote mode so it can be set by command 
rather than its front panel switches, and 3) program the desired 
output frequency. 

o Ask the operator to wait while the synthesizer is being 
programmed. 



When the synthesizer has been programmed, the counter will be told to 
begin reading the frequency output by the UUT, and report the 
resulting measurement data back to the Controller. This portion of the 
program will: 

□ Indicate that the test is in progress, 
o Address the Counter as a talker. 

□ Put the Counter into remote mode so it will be set by Controller 
commands rather than by its front panel switches. 

□ Trigger the readings. 



Collect the resultant data. 




The Transfer Module is included so the operator can select where to 
transfer the measurement data. It can be filed and/or printed, or 
discarded by continuing the test or exiting. This module will: 

o Display the test results. 

□ Display selections for the Operator and accept the selection to 
branch to the File or Print modules, to continue the program at the 
Frequency Synthesizer Module, or to exit with no further testing. 



Filing Module 

If the operator elects to file the data, a channel is opened to the floppy 
disk, and the data is recorded there. When filing is complete, the 
program returns to the Transfer Module. Notice that in this sample 
system, the data can only be filed once. In a real application, a virtual 
array would probably be used in order to increase the amount of test 
data that could be filed. 



Printer Module 

If the operator wishes to print the data, the program branches to the 
Printer Module, and returns to the Transfer Module. In a real 
application, this module would probably send an entire data file to the 
printer, rather than just the array that contains the single set of test 
data. 



This module insures that if an error occurs while the program is 
running, the program itself can handle it, rather than halting. It 
displays a message to the operator that an error has occurred, some 
information about the error, and requests a decision whether to 
continue or exit. If Continue is selected, the program returns to the 
Frequency Synthesizer Module. If Exit is selected, it goes immediately 
to the exit module. 

Exit Module 

The Exit Module can be as short as one line: END. In this program, 
however, two lines are used that include six separate commands, five of 
which are “housekeeping”. The housekeeping commands clear the bus, 
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4: Concatenate 

Now that each portion of the program has been written and found to 
operate properly, they are linked together, or concatenated. During 
the writing phase, the line numbers in each of the modules were given 
the same first digit, and they were assigned in the range that the 
eventual program would use them. For example, the Setup Module 
was assigned numbers in the 100 to 199 range; the frequency counter 
module 200 to 399, and so on. 

Each module was recorded to a filename that recalled its place in the 
order of things: Setup module toNEWl.BAS, First Screen module to 
NEW2.BAS, Frequency Synthesizer module to NEW3.BAS, and so 
forth. It is a simple matter to use the File Utility program to merge the 
modules. Then, when the program is loaded using the BASIC 
Interpreter program, the line numbers can be renumbered using the 
REN statement. 



5: Debugging 

Many programmers write all the code, then start debugging. While this 
approach may seem to be more efficient, in the long run it only leads to 
trouble. Fix the little problems as they arise so they are less likely to 
have larger effects later on. 



For example, the program might seem to work, but have you tried 
asking the Synthesizer to output maximum frequency? Minimum? 
Before a program for this system is really up and running, we have to be 
sure that it will accept any parameters. Perhaps the operator can be 
instructed not to choose the highest range of the Synthesizer, because 
the program still needs a little work. It is probably a better idea, 
though, to eliminate those selections if that part of the program is still 
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Debug the Program 

and Document Your Work 



Unfortunately, debugging is something of an arcane art. The 
techniques used are not easily taught or learned, so most programmers 
develop techniques of their own through experience. The BASIC 
Programming Manual includes a section on debugging, and discusses 
many proven techniques. 

One technique is to “comment out” the program lines that cannot be 
used until the actual system is set up. All that is involved is to put an 
exclamation point immediately after the line number that you don’t 
want as part of the program. During the development of the Frequency 
Test program, for example, all the lines containing IEEE-488 
commands were commented out because they would cause errors until 
the IEEE instruments were connected. This technique leaves the 
program relatively intact, and it is a simple matter to re-indude any 
dropped lines later. 



Another technique is to insert GOTO statements to route program 
execution around known areas. This could be used, for example, to not 
include the First Screen module to save time. Another frequently used 
technique is to put a RETURN statement at the first line of an 
unfinished subroutine. 



Step 6: Document the Program 

Be sure to adequately document your work, This is one of the last steps, 
but one which you can work on as the program evolves. No program 
should be undocumented. This means you! Someday, you will no 
longer be with the Bitty Widget Corporation, but will have moved on 
to the Mighty Widget Programming Consortium. What happens to 
program maintenance when the Author leaves, but his programs don’t 
give a hint as to how they work? As technology advances, all your 
efforts will be thrown out if someone else is not able to look at the code 
and see what you had in mind. 

Not every line needs a comment, but leave some clues at least. Every 
programmer, at some time, has needed to re-invent a routine simply 
because it was more work to figure out what his predecessor had done 
than it was to start from scratch. 
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io 

20 

30 

so 

60 

70 

80 

90 

too 

1 iO 
120 
130 
140 
150 
160 
170 
180 



« » « F R E 


Q U £ N C Y 


TEST 


P R 0 0 R 


<your nBMe> 








<date written> 








< ident I f 1 cat i on> 


[test disk! 


f i lensMe 


frsncy.tstl 



This perfor** e fre'tuenew t«»t In two rensos for the 

6070/lA fre*iuencw swnthes later and a 19S3A fra<«uenc« counter. 
Notes! 

- The 1953 Counter eust have ortion C Installed for Ranse 2. 

- Ranse 1 is 20 WHz output, ranse 2 is 200 WHz. 

The synthesizer is IEEE-488 address 01. the counter is 02. 

The prosrea takes ten aeasureeents and stores the* In an arrow. 
Then the results are displayed, and the operator decides whether 
to file or print the arrow, continue testinfl. or exit. 



190 

200 

210 

220 

230 

240 

250 

260 

270 

280 

290 

300 

310 

320 

330 

340 

350 

360 

370 

380 

390 

400 

410 

420 

430 

440 

450 

460 

470 

480 

490 

300 

SIO 

520 

530 

540 

S50 

560 

370 

580 

S90 



! All operator selections are eade bw touching the screen. 

♦ 

! - Setup hodule - 

5 Error vector, array for data, escape sequences, link to "sraph" 

I 

ON ERROR GOTO 1510 
Din AU1%> 

BP* = CHR*<7) 

ES* = CHR*<27) + “E2J" 

PRINT ES*;CHR*(27)+"C?8l"J 
LINK "GRAPH. OB J*' 

GRPOFF \ ERAGRP <0%1 
GOTO 470 

I 

f Selection Box Subroutine 
I Draws a box around TSO keys 

9 

MOVE (XG%.Y6%> 
nOVE (XGX.YGZ) 

PLOTR (80%, 0%, 1%) 

PLOTR (0%. -50%. 1%) 

PLOTR (-80%. 0%. 1%) 

PLOTR (0%. 50%. 1%) 

6RP0M 
RETURN 

I 

! - First Screen • 

I 

PRINT BP*I E8$l CPOS < 6 . 34 ) ! "FREOUENCY TEST"! 

PRINT CPOS (8.20) ; "Check all connections, and #ppIw. power to the"! 
PRINT CPOS (9. 20) » "test instrueents. Touch the screen when ready."! 
KR% « KEY \ WAIT FOR KEY \ KRX - KEY ! reset tso \ wait \ Set key 

I 

! - Fresuencw Synthesizer Aodule - 

} 

PRINT E8*J \ 6RP0FF X ERAGRP (0%) 

XQ% - 360% \ YGX » ISOX \ 60SUB 360 

XQX > 360X \ YGX « lOOX \ G08UB 360 ! draw three boxes 

XCX » 360X \ YGX » 50% \ G0SU8 360 

PRINT CP08(2,20)!"PLEA8E SELECT FREQUENCY SYNTHESIZER RANGE"! 

PRINT CPOS (7.25)! "RANGE U 20 NHz"! 



*aln eeeorw array to rev data 
beep 

erase screen 

clear the screen, disable cursor 
link to SraphicB ob-iect file 
Sraphics plana off. then erase 
display first screen 



current position is defined 
current position is defined 
prior to the Sosub coeuands 

! box is 80 X 50 Pixels 
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600 

610 

620 

630 

660 

650 

660 

670 

680 

690 

700 

710 

720 

730 

760 

750 

760 

770 

780 

790 

800 

810 

820 

830 



650 

860 

870 



890 

900 

910 

920 



PRINT epos (ilr25>r’RANGE 2* 

PRINT CPOS <15,37)> "EXIT"; 

KR% » KEY \ WAIT FOR KEY \ KR% * KEY 
IF KR% - 17X OR KRX - 27% THEN 680 



K«t r<!&Pon«e 
rantfe 1 sel«ct«d 



IF KRX - 37X OR KRX - 67X THEN 710 
IF KRX = 36X OR KRX - 37X OR KRX - 
PRINT BP»I E8« 

WAIT 666 \ PRINT BP*; \ QOTO 550 
RX <• 1 

PD* » "FR20rtZrAPiV" 

GOTO 710 
RX ** 2 

"FR200nZ,APiy 



S8X THEN 1670 



rBn*« 2 



; invalid 



selected 
• exit 
repeet 



( r«n*e 1 protfrsta data; 
• 20 NHz t 1.0 V 



range 2 



proSrasi 
g i.O V 



! Selection aade. so prosraa instruaervts 



GRPOFF \ ERAQRP <0%> 
PRINT ES*J CPOS (6,32) 
PRINT CPOS (6,23)J"Pro! 
INIT PORT 0 
CLEAR ei 
REMOTE 8182 



PLEASE WAIT - "i 
ins Synthesizer for R 
! initialize 
f clear synthesizer 
! both to r 



WAIT 666 



960 



- Frequency Counter Module - 

CPOS (6,15);" M« 

82 

( « 1 TO 10 

!2, "F0R2A0S0M1H1T" ! chnnl A, If 

! sep . outf 

PRINT CPOS(16,60m%l ! displays 

WAIT 500 i takas a r 

52, A(IZ) ■ puts the 



SB, ac couple, 

, SR8 , tr i SSsr 
Ich count is b 
HnS every h 
lents i 



If sec« 



980 

990 

1000 

1010 

1020 

1030 

1060 

1050 

1060 

1070 

1080 

1090 

1100 

1110 

1120 

1130 

1160 

1150 

1160 

1170 

1180 



ERAGRP <0%> \ 

PRINT BP»J ES*I CPOS <2,1M"TE8T RESULTS* * 
PRINT CPOS (6,0) 

PRINT USING Ad. .5), 

PRINT USING A(6..10), 



' foraat for display 
! 2 rows, 5 coluans 
! array eleaents 1"5 
! array e 



XGX - 76X 
XGX » 225% 
XGX - 376X 



\ YGX = 90% \ 60SUB 360 

\ YGX « 90X \ GOSUB 360 

\ YGX - 90% \ GOSUB 360 

PRINT CPOS <12?i6);^“FILE'';CP0Sd2,32) I "PRINT" ;CP0S (12, 69) ("CONTINUE'' 
PRINT CPOS (12,70)1 "EXIT" 

PRINT CPOS <16,33)1 "Please Touch Selection"! 

KRX - KEY \ WAIT FOR KEY \ KRX - KEY 
IF KRX « 61X OR KRX « 62X THEN 1210 

IF KRX « 66X OR KRX • 65X THEN 1320 

IF KRX - 67X OR KRX * 60X THEN 560 

IF KRX “ 69% OR KRX “ 50% THEN 1660 

PRINT E8*{ BP*; S WAIT 666 \ GOTO 1000 



draw the boxes 



! file A in "FRQNCY.DAT" 
‘ print the array 
i back to test 
! exit 

! Invalid - repeat 
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1190 ! - Filins floduU - 

1200 • 

1210 PRINT E8»; CP08 <4.30)l"0n« MO«entr flUnS"? 

1220 »AIT 2000 
1230 CL08E 1 

1240 OPEN '•ttF0«FR8NCy.0AT‘' AS NEW FILE 1 { fllenBaa •'frnncw.dst" 

1250 PRINT SJl, USING ”S«M , US##''*''''" , Ad.. 10) i stor® array aleaants 1-10 

1260 PRINT ESS) CPOS <4.20)J "Data has baert filed - returning to «enu"l 
1270 ‘ 

1280 WAIT 750 \ GOTO 990 f return to transfer sodule 

1290 ! 

1300 ! - Printer hodule _ 

1310 ! 

1320 GRPOFF 

1330 PRINT ESt» CPOS (4.30)5 "One ssoaent. printing"? 

1340 • 

1350 CLOSE I I _ _ _ note* _ _ _ i 

1360 OPEN 'K81*' AS NEW FILE 1 ’ be sure to check port psraaeters * 

1370 PRINT 81. CMRf(12%) ! before aakinS this selection. ? 

1380 PRINT »lr "TEST RESULTS" 

1590 PRINT USING "118 . Hlf . Ad. .10) 

1400 PRINT ESfr CP0S<4.2Q); "Data has been printed - returning to senu"l 

1410 CLOSE 1 

1420 WAIT 75D \ GOTO 990 

1430 ‘ 

1440 1 - Exit nodule - 

1450 ! 

1460 CLEAR tl N CLOSE ALL 

1470 PRINT ES«; CHRt ( 27 > + "C?8h" S GRPOFF \ ERAGRP (0%) \ END 
1480 ! 

1490 i - Error Handler Nodule - 

iSOO ! 

1510 GRPOFF \ ERAGRP (0%) \ PRINT ES$ 

1520 ^G% = 300% \ YG% » 130% \ GOSUB 360 ! draw the boxes 

1530 XG% = 300% \ YG% = 60% \ GOSUB 360 

1540 PRINT CPOS (3,5)5 "Sastea Error ~"i 

1550 PRINT CPOS (4,5)1 "Check instruments end connec t i ons" 5 
1560 PRINT CPOS (S,5>? "before cent i nu i ng . " I 
1570 PRINT BP«J CPOS (10,40)1 "CONTINUE" 5 
1580 PRINT CPOS (15,42)5 "EXIT") 

1590 KRX = KEY \ WAIT FOR KEY \ KRZ » KEY 

1600 IF KRX - 26% OR KRX » 36% THEN 1610 ELSE 1620 • continue 

1610 GRPOFF \ ERAGRP (0%) \ PRINT ES« \ RESUHE 990 

1620 IF KRX « 46% OR KRX » S6X THEN RESUNE 1470 f exit 

1630 \ 

1640 PRINT E8i5 BPS) \ WAIT 666 \ GOTO 1550 ! invalid - repeat 

1650 ! 
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The Startup Command File 

One final thing is needed to make the resulting program truly stand- 
alone: the Startup Command file that will make all the rest happen 
from power up. In this sample programming session, the Command 
file will be the last thing written. It is a relatively minor portion of the 
entire task; but without it, it would be necessary to leave the keyboard 
attached to get the program operating. With it, the keyboard can be 
detached entirely, and the program will run on its own whenever the 
disk is loaded and power applied. 

To complete the automation of this program, the Startup command 
file must do two things: 

□ Load the BASIC Interpreter program. 

□ Run the Frequency Test program, FRQTST.BAS 



CONCLUSION 

This section has given guidelines on Automating the I722A Instrument 
Controller. It has used a sample instrumentation system to show how 
to write and develop programs that will be useful for a system of this 
sort. Larger systems are of course possible; in fact up to 1 5 instruments 
can be connected onto the same IEEE-488 bus. If another Controller is 
one of them, 15 more are possible, and so on. No matter how big the 
final system is to be, the guidelines given here should make the 
programming task much easier. 

Start with a flowchart. It will be a valuable guide once you’re down 
inside all those GOSUBs and FOR-NEXTs. Program in small 
amounts, then concatenate. Test each module; test each parameter; 
test each selection. Make sure the program works as you designed it to 
do. Finally, document your efforts. If you stay with the same company, 
your task will be much easier if you don’t have to relearn the program 
before you can update it. If you leave the company, your successor will 
have a lot less trouble figuring out how the program was supposed to 
operate. 
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INTRODUCTION 

The 1722A Instrument Controller features a display that can provide a 
great deal of visual information to the operator. Dot-addressable 
graphics, coupled with the state-of-the-art Touch Sensitive Display, 
makes it possible to design displays that are meaningful and 
interesting, and that provide a high degree of interaction between the 
operator and the Controller. 

The 1722A supports all of the features incorporated in the 1720A, but 
expands the display capabilities by using more of the ANSI Standard 
controls, and by incorporating a set of graphics routines contained in 
the object files “GRAPH. OBJ”, and “GPRINT.OBJ” on the System 
disk. 

The 1722A includes 256 displayable characters in two character sets. 
The 128 characters in the standard set are the full ASCII set, and the 
alternate character set can be customized for characters in languages 
other than English, or for custom applications such as logos or other 
special symbols. 
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CHARACTER PLANE 

Display information is stored in two separate sections of memory, the 
character plane and the graphics plane. Each display memory is 
independent; that is, they can be enabled or disabled separately. When 
both are enabled, displayed characters can be made either opaque or 
transparent to the graphics portion of the display. 

A pad of 50 Programming Worksheets is provided with the Controller. 
The grids printed on the sheets are helpful in the design of displays that 
use the Touch-Sensitive Display. Columns and rows are indicated for 
both normal- and double-size characters, and each of the 60 touch- 
sense key locations is clearly marked. 

The character set EPROM contains two character sets. The primary 
character set is ASCII, with some Greek characters and commonly 
used symbols. The table in appendix F shows the display responses for 
the primary character set. 



Depending on the revision level of the Video-Graphics-Keyboard 
module, the alternate character set may be a duplicate of the primary 
set, or may be a selection of non-English characters and additional 
symbols. 



The character EPROM is a readily available 2732 type, which can be 
programmed with very little effort to display any character set desired. 
Appendix E of this manual explains how to design a custom character 
set, and includes a short BASIC program that displays all the 
characters in both character sets. When the program is run, the 
primary set is displayed in double size characters. When you touch the 
screen, the alternate set is displayed. The program toggles between 
displaying first one set then the other, to allow you to compare them. 
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Character Graphics 

Besides individual characters, straight horizontal and vertical tines can 
also be included in displays on the character plane. An example of this 
usage is the program “MASTER. BAS” on the Getting Started disk. 
This program uses only the character plane. The graphics plane could 
easily display this grid, but is only needed for displays where diagonal 
lines or motion simulation are used, as in the program called “WOW” 
on the Getting Started Disk. In fact, the program titled “TOUCH” on 
the Getting Started Disk displays all 60 touch sense locations using the 
Graphics plane. The Graphics plane is discussed in more detail later in 
the section. 



The table on the next page shows the graphics characters that are 
contained in the character set EPROM. With character graphics 
enabled, the characters 0 through 9 and the colon (:) result in the 
display of these symbols. 
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CHARACTER 


NORMAL SIZE 


DOUBLE SIZE 




0 


D 


1 


i1 




Top Right Corner 


1 


D 


■ 


n 




Top Left Corner 


2 


E 




i 




Bottom Right Corner 


3 


Q] 




IS 




Bottom Left Corner 


4 


□ 


■ 


[i 

■n 




Top Intersect 


5 


Q] 


1 


ti 




Right Intersect 


S 


J] 


■ 


n 




Left Intersect 


7 


HIH 




mm 

!■ 

1 




Bottom Intersect 


8 


□ 




ssss 

■ 

■HB 




Horizontal Line 


9 


E 


■ 


s 




Vertical Line 






1 


Tm 

u 




Crossed Line 



NOTES; 

1 . To enable Graphics Mode, send the display ESC [ 3p or ESC [?3h 

2. To disable Graphics Mode, send the display ESC [ 2p or ESC [?3I 

3. In Graphics Mode, characters in the left column aredisplayed as shown, 

4. Use the character names as defined to construct illustrations that do not change 
form between normal and double size, 
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Two sample Interpreted BASIC programs are used here to illustrate 
howto create a display using the 1722A Character Graphics capability. 
The first program displays all of the graphics characters, first in normal 
size, then in double size. The second program uses the characters to 
display an area the size of approximately one touch-sensitive key. Both 
of the programs make use of escape sequences to clear the screen and 
put it into character graphics mode. The first program also uses an 
escape sequence to make use of double-size character mode. These 
control sequences are descibed in more detail later in the section. 




10 E« = CHR«(27) + \ CL«i “ ES + "2J" 

20 PRINT CLSj + •■3p"i CP0S(8,24)j eOSUB SO 
30 PRINT CL«; E* + CPDS<4. S)i \ SOSUB 50 

40 PRINT E* ■■i2p"iCL* \ GOTO 20 
50 PRINT "0 1 234 56789 :" 

60 PRINTS PRINTN PRINT “ Please Touch the Screen"i 

70 WAIT FOR KEY \ KX » KEY \ RETURN 

In the first program, the first line establishes an escape sequence 
variable E$ as ASCII 27 + the left bracket character. This sequence 
saves typing the entire escape sequence later in the program. The 
second part of line 10 establishes a variable CL$ (clear) as the escape 
sequence just defined ( <ESC>) + “[2J”. This sequence will be used later 
in the program to clear the screen before each of the displays. 

Line 20 clears the screen, then enables the graphics display (3p). The 
line ends by sending the program to the subroutine at line 50, which 
now prints the characters 0 through 9 and the colon (:), resulting in a 
display of the 10 graphics characters. 

When the subroutine is stopped by touching the screen, the program 
returns to line 30, where the screen is again cleared, and the escape 
sequence given the parameters to go to double size, and to once again 
enable the graphics display (l;3p). 

The display toggles between normal- and double-size characters for 
comparison. The program stops when <CTRL> /C is pressed. 
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The Character Plane 



Program to Display One Touch-Sense Keypad 



This second sample program uses the graphics characters to draw a 
box the size of one touch-sense keypad. Notice that the program begins 
by assigning the escape sequences. 



10 

20 

30 

40 

50 

60 

70 

80 

90 

100 



« CHR«(27> - "C" \ CL* “ E» ♦ 2w 



PRINT CL»; E* + 
PRINT CP0S<4, 40 
PRINT CP0S(5. 40 )J 
PRINT CP0S<6, 40 )i 
PRINT CP0S<8, 37); 
WAIT FOR KEY 
PRINT E* + '‘2p'' 
PRINT CPOS(B. 37 



“9 

■■3B8S882" 
"Touch to exit 



Thank you. 



T 2000 \ PRINT CL* \ END 



The display resulting from this sample program looks like this: 
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tNTRODUCTION TO ANSI STANDARDS 

The American National Standards Institute publishes ANSI Standard 
X3.4, which describes the American Standard Code for Information 
Interchange, or ASCII. Since its initial publication in 1968. ANSI X3.4 
has become the industry accepted standard for defining a 7-bit 
character code. 

Another ANSI standard, X3.4I, describes recommended code 
extension techniques for use with ASCII. In essence, the standard 
specifies how to represent ASCII in an 8-bit environment. 

The 1722A Instrument Controller implements both ANSI standard 
X3.4 and applicable code extension techniques from ANSI standard 
X3.41. This compliance assures the upward compatibility of Fluke 
products as well as the ability of the Controller to communicate 
effectively with the products of other manufactures. 
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Eleven of the ASCII characters are interpreted by the Video-Graphics- 
Keyboard module (VGK) as display control characters. In addition to 
these eleven control characters, two others (ASCII 24 and 26, 
CANCEL and SUBSTITUTE) are used by the system’s 
microprocessor to cancel a display control. These codes are not sent on 
to the VGK module. 

The display control characters as summarized in the next table, must 
be preceeded by an. escape sequence. 



ASCII DISPLAY CONTROL CHARACTERS 



(CTRL) 


ASCII 


MNEMONIC 


RESULT 




0 


NUL 


Null; no action. 


G 


7 


BEL 


Sounds a tone. 


H 


8 


BS 


Moves the cursor left one column, if it is not 
already positioned at the leftmost column. 




9 


HT 


Moves the cursor to the next tab stop, (every 
8 columns). 


J 


10 


LF 


All of these commands move the cursor to the 


K 


11 


VT 


next line down in the same column. The display 


L 


12 


FF 


scrolls up if the cursor is on the bottom line. 


M 


13 


CR 


Moves the cursor to the beginning of the current 
line. 


N 


14 


SO 


Selects alternate character set. 


0 


15 


SI 


Selects the standard character set. 




24 


CAN 


Cancels a display control. 




26 


SUB 


Substitutes a character sequence if sent as 
part of the sequence. 




27 


ESC 


Starts a display control character sequence. 
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.soap# Sequences 

Besides display control characters, the ANSI Standard also specifies a 
set of Code Extension Techniques (Escape Sequences) which can be 
used in controlling the display. These techniques use commands in the 
form: 

(ESC) [ {parameter 1} ; {parameter 2} ; (parameter n} {terminator} 

□ The <ESC> [ is called the Control Sequence Identifier. All control 
sequences except scrolling commands begin with this identifier. 

n The parameters may be either numeric or selective. If the sequence 
uses numeric parameters, and no number is given, zero is normally 
assumed. Cursor controls assume 1 if no number is given. 

o The terminator is always an alphabetic character. 

Any number of commands can be specified within a given command 
set as long as each is separated by a semicolon (;). Ill-formed 
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Numerically-Defined Display Control Sequences 

The 1722A uses the same display controls as those used for the 1720A, 
and some additional ones. Many of the sequences shown in the table on 
the next page are equivalent to ANSI Standard Selective Parameter 
Sequences, which are discussed later in this section. 

The default condtions are indicated by an asterisk (*). 




FUNCTION 


CONTROL 

SEQUENCE 


COMMENTS 


Cursor Controls 






Up n lines 


<ESC).(nA 


The cursor stops at the edge 


Down n lines 


<ESC)(nB 


if the number given as an argu- 


Flight n columns 


<ESC)[nC 


ment results in movement past 


Left n columns 
Direct to line, column 

Scroll down one line 
Scroll up one line 
Scroll to start new line 


<ESC>[nD 

(ESOfI; c H 

<ESC)D 

<ESC>M 
(ESC) E 


the edge of the screen. 


Erasing 






To end of display 
To start of display 
Ail of display 


(ESC) [J or (ESC)[0J 

(ESC)[1J 

(ESC) [2J 




To end of line 
To start of line 
All of line 


(ESC)[K or (ESC) [OK 
(ESC) [IK 
(ESC)[2K 




Attributes 






Attributes Off* 
High Intensity 
Underline 
Blinking 
Reverse Image 


(ESC)[m or (ESC)[0m 

(ESC)[1m 

(ESC) [4m 

(ESC) [5m 

(ESC) [7m 




Cursor Status 






Request cursor position 


(ESC) [6n 


For a program to make use 


Cursor position report 


(ESC)[I, c R 


of the report, a logical input 
channel must exist between the 
program and KBO: 


Size of Characters 






Normal 


(ESC) [p or (ESC) [Op 


These commands affect the 


Double 


(ESOflp 


entire display. 


Character Graphics 






Disabled* 


(ESC)[2p 


These commands also affect 


Enabled 


(ESC)[3p 


the graphics plane. 
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DISPLAY CONTROL SEQUENCES (cont) 



FUNCTION 


CONTROL 

SEQUENCE 


COMMENTS 


Keyboard 






Enabled* 


<ESO[4p 


Even when disabled, the key- 


Disabled 


(ESC) [5p 


board can respond to control 
codes. To exit a locked condi- 
tion, use (CTRD/T to unlock 
the keyboard, reset the screen 
to normal-size characters, home 
the cursor (upper left), and dis- 
able the graphics plane. 


Cursor Type 






Blinking Underscore* 


(ESC) [Ox 




Steady Underscore 


(ESC) [lx 




Blinking Block 


(ESC) [2x 




Steady Block 


(ESC)[3x 





ndicates the default conditions. 
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Selective Parameters 

vSelective parameters are defined with a number followed by a number. 
These parameters are always a string with the first character a question 
mark (?), and the second a numeric character between 1 and 8. The 
terminator is either the lower case letter ‘h’ (SET or high), or the lower- 
case letter ‘1’ (RESET or low). As with numerically defined parameters, 
selective parameters are always started with the “Control Sequence 
identifier”, <ESC>[. 

□ To SET a mode, the terminator is the lower case letter ‘h’. 

□ To RESET a mode, terminate with a lower case letter ‘F. 

The table below summarizes the ANSI Standard Selective parameters. 
The defaults are indicated by an asterisk (*). 



UMMARY OF MODE SELECTIONS 



MODE 


RESET (I) 


SET (h) 


?1 


Field Attributes* 


Character Attributes 


?2 


Single Size* 


Double Size 


?3 


Disable Character Graphics* 


Enable Character Graphics 


?4 


Keyboard Unlocked’ 


Keyboard Locked 


?5 


Opaque to Graphics* 


Transparent to Graphics 


?6 


Disable Character Display 


Enable Character Display* 


?7 


Disable Graphics Display 


Enable Graphics Display* 


?8 


Disable Cursor Display 


Enable Cursor Display* 



^Indicates the default conditions. 
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The field attributes are identical to the non-transparent field attributes 
used on the 1720A. When this mode is RESET, all attributes, such as 
blinking or inverse video, are defined for a field on the display before 
the characters themselves are placed there. Both Field and Character 
attributes use the numeric parameter escape sequences. 

NOTE: 

The refresh scanning rate exceeds the rate that characters are 
written to the screen. Therefore, in the field attribute mode, the 
underlining and reverse image commands will cause the entire 
remaining display to momentarily exhibit the attribute until 
the attributes-off command ( (ESOfm or (ESC) [Om) is 
recieved. 



To avoid the ‘flashing’’ associated with this phenomenon, first 
position the cursor to the location for the attributes-off 
command, then return it to the location for the attributes and 
the message to be displayed. 

The entire display is either in field or character attribute mode; field 
mode is the default. 



In the character attribute mode, attributes are associated with 
individual characters rather than with an area of the display. These 
attributes do not use a display position, so it is possible to highlight a 
single character within a word, for example. 

If the ANSI Standard Mode “?I” is SET (h), then 1720A-type field 
attributes are disabled, and character attributes are enabled. 

In the character attribute mode, displays need not include the leading 
and trailing spaces on the display associated with field attributes. 
Additionally, new enhancements can be added without resetting 
previously set ones. (They are “sticky”.) As new enhancements are sent 
to the display, they are added to an already existing list until they are 
reset by the reset enhancements command (ESC) [Om. When the set 
mode command is first received, the screen is cleared, and the cursor is 
homed. 

As shown in the next table, many of the selective parameters have 
equivalent numerically defined parameter control sequences. The 
default conditions are indicated by an asterisk (*). 
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LECTIVE PARAMETER DISPLAY CONTROLS 



FUNCTION I 


MODE 

SELECTION 


EQUIVALENT NUMERIC SEQUENCE 


Attribute Mode 




: No equivalent. 


Field* 


<ESC>[?1I 




Character 
Character Size 


(ESC>[?1h 




Norma!* 


; <ESC>I?2I 


(ESC) [Op 


Double size 
Character Graphics 


<ESC>[?2h 


(ESC) [Ip 


Disable* 


(ESC) [?3I 


Similar to (ESC)[2p and (ESC)[3p, 


Enable 

Keyboard 


(ESC) [?3h 


except that these commands do not 
affect the graphics plane. 


Unlocked* 


(ESC) [?4I 


(ESC)[4p 


Locked 


(ESC) [?4h 


(ESC)[5p 


Opaque to Graphics* 


(ESC) [?5I 


When this command is received, any 
graphics displays that cross display 
character cells are hidden behind the 
character cell, an area 8 pixels wide and 
14 high. This mode is used to make 
characters stand out from surrounding 
graphics displays. There is no equivalent 
capability for the 1720A Controller. 


Transparent to Graphics 
Character Display 


(ESC) [?5h 


This mode causes displayed characters 
to be transparent to the graphics 
display. Any graphics displays that 
cross a character cell are not ob- 
structed by the cell. Select this mode 
to blend characters into the graphics 
display. 


Disable 


(ESC)[?6i 


No equivalents. 


Enable* 

Graphics Plane 


(ESO[?6h 


Disable* 


(ESC)t?7l 


No equivalents. 


Enable 

Cursor Display 


(ESC)[?7h 


Disable 


(ESC)[?8I 


No equivalents. 


Enable* 


(ESC)[?8h 



ndicates the default conditions. 
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Non-Destructive Display Character 

Sometimes you may want to call attention to a word or phrase which is 
already displayed on the screen by changing its display attributes. An 
example of this would be a menu item which the user has selected by 
touching the screen. To indicate the selection, it would be desirable to 
highlight the characters which make up the selected menu item. 

When character attributes are selected, there is a means of changing the 
display attributes of a character on the screen without actually re- 
writing the displayed character. That is the purpose of the non- 
destructive display character. Whenever this character sequence is sent 
to the display, the character at the current position of the cursor will 
take on the most recently specified character attributes, without 
changing the actual text on the display. In addition, the cursor moves 
to the next character position, just as it would if you had sent a normal 
text character to the display. In this way, any number of text characters 
can be assigned new display attributes. 

The non-destructive character consists of the two character sequence: 

<ESC>- 

As an example, suppose the text string “Hello world” has been 
displayed in the upper left corner of the screen. We wish to assign 
highlight attributes to each of the characters in this message. The 
following fragment of a BASIC program could be used to perform this 
operation. 



100 ND« » CHR*(27%) + 

110 HM« « CHR«<27%) + ’‘CH" 

120 HL$ « CHR*(27%) + "llm" 

130 PRINT HM«i 

140 PRINT HL«J 

150 FOR 1% « 17. TO 11% 

160 

170 NEXT 17. 



! define the non-destructive character 
! define the home cursor function 
! define highlight attribute 
i home the cursor 
! select highlight attribute 
I use a loop to "touch" each character 
! in the text string 



In this manner, the display attributes of any text string can be 
modified, without re-writing the original message. 
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Information to be displayed is held in two separate portions of 
memory: the character plane and the graphics plane. Both of them can 
be turned on and off using the ANSI Standard Control Sequences just 
described. Additionally, the graphics plane can be turned on and off 
using two of the routines in the Object File named “GRAPH. OBJ”. 

To use the Graphics Routines described in theis section, your program 
must link to them. For example, using the BASIC Interpreter line 

LINK “GRAPH” 

early in the program will link the graphics routines and enable them to 
be used throughout the program. 

If you will be compiling the program with the BASIC Compiler, do not 
include the LINK “GRAPH” statement in the program. Instead, use 
the Linking Loader (LL) to link your program‘s object file with the 
graphics routines as shown here: 



LL > I <prog-ram name>. B4L0AD. GRAPH 
LL > O •CprogT'affl name> 

LL > G 




The display memory is divided into a character plane, and a graphics 
plane. Either plane can be enabled or disabled independently. 

The graphics workspace is an array of dots called pixels, a contraction 
of the words picture elements. In the horizontal direction, there are 
2048 pixels, and in the vertical direction, there are 256. The display 
screen provides a window into the graphics workspace that is 640 dots 
wide and 224 dots high. The window can be positioned anywhere over 
the graphics plane. Here is where it starts out: 





The Display 
The Graphics Plane 



If the window position is moved beyond the edges of the graphics 
plane, the display wraps around to the opposite edge. For example, 
assume that these lines have been drawn in the graphics area: 




This is what happens when you move the window to overlap the right 
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The next drawing illustrates what would happen if the window is 
positioned so that it overlaps both a vertical and horizontal edge of the 
graphics workspace. First, assume that these symbols have been place 
in the four corners of the display, and the window positioned as shown: 




The resulting display would be: 




This result may be either useful or surprising, depending on what you 
had in mind as you designed the display. Note that the effect does not 
hold true for the lower left reference corner of the window, which 
cannot be moved outside the graphics workspace. 
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Addressing the Pixel Positions 

Dot positions are addressed by their X,Y coordinates. In the first 
drawing, the display window was positioned so that its lower left 
corner was at position 0,0 (the default starting position); the lower 
right is at 639,0; upper left is at 0, 223, and the upper right corner is at 
639,223. In the last drawing, the current position has been moved so 
the lower left corner of the display is at 1722, 144. 

Pixels can be turned on or off anywhere within the window. The rest of 
this section describes the set of routines that control turning the pixels 
on and off, and moving the current position. 



raphics Routines 

The graphics routines described in this section are available to BASIC 
programs. They are recorded on the System disk in a file named 
GRAPH. OBJ, and in a library file named GRAPH. LIB. FORTRAN 
programs access these routines by using FLUK22.LIB on the 
FORTRAN disk. There are additional graphics routines described in 
the subsequent section, Printing the Graphics Plane. 

Some of the routines turn the display on or off, and others move the 
“current position”. Though the current pixel position is not displayed 
(as a cursor shows the current position in the character plane), the 
initial current position is always 0,0. As you can see by the drawings, 
position 0,0 is the lower left corner of the display. The upper right 
corner of the display window is position 639, 223. The upper right 
corner of the entire graphics plane is at location 2047, 255. 

As a program moves the pixel position, or pans the window around the 
workspace, the routines keep track of the changing current position. 

Ail the routines can be linked to programs generated by the BASIC 
Interpreter and the BASIC and FORTRAN Compiler programs. 
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The table that follows describes each of the graphics routines. Note 
that all the arguments must be integers except for the first arguments to 
LABEL and LABELF. This means that in a BASIC language 
program, for example, the arguments must be followed by the % 
symbol. In FORTRAN, variable types are determined by the first 
character in the variable name (Integers I though N), or by using the 
TYPE statement. See the particular progamming language manual for 
full details. 

All of the following routines can be called by a BASIC or FORTRAN 
program except for LABEL and LABELF. LABEL is called by a 
BASIC program and LABELF is called by a FORTRAN program. 



GRAPHICS ROUTINES 



COMMAND 


PURPOSE 


DOT (X, Y, {type}) 


Draws a single dot at X, Y, returns to the 
current position. 


DRAW (XI, Y1, X2, Y2, {type}) 


Draws a line from XI, Y1 to X2, Y2. 


ERAGRP ({type}) 


Erases the entire graphics plane. 


GRPOFF 


Disables the graphics plane. 


GRPON 


Enables the graphics plane. 


MOVE (X, Y) 


Moves to absolute position X, Y, 


MOVER (Xoffset, Yoffset) 


Moves relative to amount specified by 
the offset. 


PAN (X, Y) 


Sets display window position to X, Y. 


PLOT (X, Y, {type}) 


Plots from current position to X, Y. 


PLOTR (Xoffset, Yoffset. {type}) 


Plots relative to amount specified by 
the offset, 


LABEL(S$, D%, T%) 
LABELF(STR,LENSTR. DIR, TYPE, 
ERROR) 


Place string in graphics memory either 
horizontal or vertical 



•Type: -1 = INVERSE 

0 ™ BLACK 

1 = WHITE 
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□ The values of the X and Y arguments may not exceed 2047, and 
may only be negative in the relative commands MOVER and 
PLOTR. 

□ The X argument is the number of pixels in the horizontal direction. 
Since the screen is 640 pixels wide, the center is 320 pixels from the 
left edge. 

□ The Y argument is the number of pixels in the vertical direction. 
The screen is 224 pixels high, so the center is 1 12 pixels from the 
bottom edge. 

□ The Type’ argument determines whether the routine paints white 
on black (1), black onto white (0), or the inverse of the color 
already at that position (-1). 

□ The S$ argument is a string variable or string constant that is 
placed in the graphics plane. 

□ The STR argument is an array with one character in each byte that 
is placed in the graphics plane. 

□ The LENSTR argument specifies how many characters are in the 
STR array. 

□ The D% and DIR arguments specify whether the string should be 
placed in the graphics plane horizontally (0) or vertically (90). 

In the pages that follow, each of the routines except LABELF is 
described in detail, and some suggestions are given about the kinds of 
things that each of them can be used for. Some of the descriptions 
include program examples. The example listings are all shown as they 
would appear in programs written for the BASIC Interpreter. 
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GRAPH.OBJ 



Usage 

DOT(X%, Y%, {type%}) 

Description 

This routine places a single dot at the specified coordinates, then 
returns to the current pixel position. Because this routine returns to 
the former pixel position it is useful in the construction of detailed 
charts or graphs that require pixel resolution and are generated by a 
mathematical formula that calculates each point from the same 
position. 



X An integer 0 to 2047 that specifies the absolute horizontal pixel 
location for the dot. 

Y An integer 0 to 255 that specifies the absolute vertical pixel 
location for the dot. 

type An integer value that specifies whether the dot is painted white 
on black (1), black on white (0), or the inverse of the color 
already at that position (-1). 



This BASIC program uses DOT to draw a sine wave. It first asks for 
“Amplitude”, and then for “Period”. The amplitude is the peak-to- 
peak pixel amplitude of the sine wave that will be drawn. The period is 
used for frequency and sampling rate. Notice that the program does 
not allow a period of less than 1 . Selecting periods less than five results 
in waveforms whose resolution is too coarse for the wave to be 
observable. 



10 LINK -GRAPH" 

20 ERAGRP <07.) \ GRPON 
30 PRINT CHR*<27) + "C2J" 

40 PRINT CPOS <14>0)i "Affl|»Utude“i 
50 INPUT A 

60 PRINT CPOS (15.0)1 "P*riod"j 
70 INPUT P 
80 IF P - 0 THEN 60 
90 PRINT CHRS<27) + "C2J" 

100 FOR XX « 1 to 640 
no Y » A * SIN (XX / P) 

120 YX - 0.5 * (Y> + 112 

130 DOT (XX. YX. IX) 

140 NEXT XX 
150 GOTO 40 



link to graphics 
erase, turn on graphics 
clear character plane 
input amplitude 
amplitude: dots pesk-to-peak 
input period (sampling rate) 
period; no. of dote/cgcle 
P B 0 IS illegal 
clear character plane 
X across display 
calculate y 

integerize and offset y 
dot at calc'ed position 
continue calculation 
next value 
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DRAW 

GRAPH.OBJ 



Usage 

DRAW(X1%, Yl%, X2%, Y2%, {type%}) 



This routine draws a line from absolute position XI, Y1 to another 
absolute location, X2, Y2. If the final position is beyond the edge of the 
graphics plane, the line will end at the edge. The current pixel position 
is not changed by DRAW. 



X ! An integer 0 to 2047 that specifies the absolute horizontal pixel 
location for the start of the line. 

Y1 An integer 0 to 255 that specifies the absolute vertical pixel 
location for the start of the line. 

X2 An integer 0 to 2047 that specifies the absolute horizontal pixel 
location for the end of the line. 

Y2 An integer 0 to 255 that specifies the absolute vertical pixel 
location for the end of the line. 

type An integer value that specifies whether the line is painted white 
on black (1), black on white (0), or the inverse of the color 
already at that position (-1). 

Example 

Current position is 0,0. To draw a white diagonal line across the 

display, use; 

DRAW<0%, QX, 639%, 223%, 1%) 
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ERAGRP 

GRAPH.OBJ 

Usage 

ERAGRP {type%} 



Description 

This routine erases the entire graphics plane to the color indicated by 
{type%} , either green, black, or the reverse of the color before erasing. 
Any data within the plane will be deleted. The character plane is 
unaffected. 



type An integer value that specifies whether the screen is erased with 
white ( I ), black (0), or the inverse of the color already at every 
position in the graphics plane (-1). 




At the beginning of a program, use ERAGRP to prepare the Graphics 
plane for the display. 



ERAGRP <OX) 
ERAGRP 

ERAGRP 



! Erase to b lac k 
! Erase to green 
! Create inverse xnage 
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GRPOFF, GRPON 




Description 

These routines turn the graphics portion of a display off and on. The 
memory is left intact; the routines only determine if the graphics plane 
is displayed or not. The character plane is unaffected. 



Example 

A selection display has just been presented to the operator. When the 
selection has been made, a new display is presented that contains new 
graphics. Rather than using ERAGRP to erase the graphics plane, 
however, it is desired to leave the contents alone because the test results 
update the display for the next selection. In this case, use GRPOFF to 
turn off the graphics display. When the display is updated, the program 
uses GRPON to display the change. 
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MOVE 

GRAPH.OBJ 

Usage 

MOVE(X%, Y%) 



This routine moves the current pixel location without drawing. If 
either X% or Y% are outside of the graphics plane, the move stops at 
the corresponding edge. 



Parameters 

X An integer 0 to 2047 that specifies the absolute horizontal pixel 
location to move to. 

Y An integer 0 to 255 that specifies the absolute vertical pixel 
location to move to. 



A program has just drawn a diagonal line from the bottom left to the 
upper right corner of the screen. Now, to “lift the pencil” to get back to 
0,0, use the MOVE routine: 

M0VE(0%< OX) 
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MOVER 

GRAPH.OBJ 



Usage 

MOVER(Xoffset% Yoffset%) 



Description 

This is the relative move routine. It moves the current pixel position to 
a relative position within the graphics plane. The move is done without 
drawing; if the new position is outside the graphics plane, the move 
stops at the corresponding edge. 



Xoffset An integer -2047 to 2047 that specifies the relative number 
of horizontal pixel locations to move. 

Yoffset An integer -255 to 255 that specifies the relative number of 
vertical pixel locations to move. 

xample 



A program is being designed that draws two figures that may appear 
any place on the display. The second figure must appear immediately 
to the right of the first. After the first figure is drawn, use the relative 
move routine to move the current position relative to the ending 
location of the first figure. 




PAN(X%, Y%) 



Description 

The PAN routine moves the window around the graphics workspace. 
The reference is the lower left corner of the display window. Positive 
arguments move the reference corner to the right and up. Negative 
arguments move the reference corner left and down. PAN does not 
affect the current pixel position. 



Parameters 

X An integer -2047 to 2047 that specifies the relative number of 
horizontal pixel locations to move the reference corner. 



Y An integer -255 to 255 that specifies the relative number of 
vertical pixel locations to move the reference corner. 



During a measurement session, data has been collected by a program, 
and has become part of a data file. The operator then elects to view the 
results of the day. The program inserts the raw data into a subroutine 
that creates and draws a chart that cannot fit in one window. Use the 
PAN routine to permit viewing the entire chart. Left and right arrow 
keys can be made part of the display, to allow positioning the window 
at any area of interest. 




PLOT 

APH.OBJ 



Usage 

PLOT(X%, Y%, {type%}) 



This routine draws a line from the current position to the location 
indicated by the X and Y arguments. (Also see DRAW.) PLOT uses 
the current position as the starting place to begin drawing, rather than 
defining the starting position, as DRAW does. The current pixel 
position is updated to X,Y. 



X An integer 0 to 2047 that specifies the absolute horizontal pixel 
location for the end of the line. 

Y An integer 0 to 255 that specifies the absolute vertical pixel 
location for the end of the line. 

type An integer value that specifies whether the line is painted white 
on black (1), black on white (0), or the inverse of the color 
already at that position (-1). 



xampie 

Use PLOT rather than DRAW in those instances where the starting 
position will be unknown, but a line is desired from one place to some 
other position. This routine can be used in constructing some types of 
graphs, like pie-charts. As the program collects data, the value of the 
data would be inserted into a Relative Move statement, and the PLOT 
statement would draw the line from the starting point to the calculated 
position (which then becomes the new current position). 




PLOTR 

GRAPH.OB 



Usage 

PLOTR(Xoffset%, Yoffset%, {type%}) 



Description 

The relative plot routine draws a line from the current position to the 
location indicated by the Xoffset and Yoffset arguments; it is similar to 
DRAW, except that as it returns to the starting position, continues 
drawing; it doesn’t “lift the pencil”. 

Parameters 

Xoffset An integer -2047 to 2047 that specifies the relative number 
of horizontal pixel locations for the end of the line. 

Yoffset An integer -255 to 255 that specifies the relative number of 
vertical pixel locations for the end of the line. 

type An integer value that specifies whether the line is painted 
white on black (I), black on white (0), or the inverse of the 
color already at that position (-1). 



xampie 

A triangular figure is to be drawn, and it may appear anywhere within 
the graphics plane. Use the Plot Relative routine to draw the figure 
relative to any starting position. This example draws a triangle that will 
be black if the field is green, and green if the surroundings are black; 

!«tOVE (OX. OX) 

PL0TR(60X. 60X, ~IX) 

PL0TR<60X. -60X. ~1X) 



PLOTR 




LABEL 

GRAPH.OBJ 



Usage 

LABEL( {string}, (direction), {type}) 



This routine places a string of characters in the graphics plane. These 
characters appear exactly as they would if displayed normal size in the 
character plane. The character string can be positioned horizontally or 
vertically. The current pixel position determines the starting position 
of the siring. The current pixel position is updated so that a subsequent 
LABEL routine call will cause string concatenation. See subsequent 
examples on string positioning. If the final position of the string is 
beyond the edge of graphics memory, the string will wrap around and 
continue at the opposite edge. 

The LABEL routine puts a string into the graphics plane at the rate of 
about 1 /60 of a second per character which means that it takes about 
1.3 seconds to draw an 80-character string. 

if keyboard input occurs during a long series of drawing operations, 
there could be up to a 6.5 second delay in responding to the input. This 
delay time also occurs with (CTRL)/C, (CTRL) / P, and the ABORT. 



Parameters 

string This is a string constant or a string variable. Each 
character of the string is taken from the character 
EPROM. If access to the alternate character set is desired, 
the string should contain the ASCII control character SO 
(shift out, decimal 14). All characters after SO are taken 
from the alternate character set until the ASCII control 
character SI (shift in, decimal 15) is encountered. The Si 
causes selection to revert to the primary character set. The 
default is the primary set, so all selection is from the 
primary set unless SO is encountered. 

The maximum length of a string that can be placed in the 
graphics plane with a single LABEL call is 80 characters. 
Since the control characters SO and SI are not displayed, 
they are not part of the 80 character string length. If the 80 
character string length is exceeded the string will be 
truncated. 




LABEL 

GRAPH.O 



direction This is an integer 0 or 90. If the direction is 0, then the 
string will be horizontally oriented in the graphics plane. 
If a direction of 90 is given, the string will be positioned 
vertically. See subsequent examples. 



This is an integer 0, 1, or -1. It determines whether the 
routine paints a white label on a black screen (I), black 
label on a white background (0), or the inverse of the color 
already at that position (-1). 



type 




LABEL 

APH.OBJ 



rrors 

2006 - direction argument not 0 or 90 



This BAvSIC program places a 26 character horizontal siring in the 
graphics plane. An initial MOVE changes the current position to 
100,150, the place where the bottom left corner dot of the first 
character cell of the string will be. LABEL updates the current position 
to the dot immed lately to the right of the bottom right corner of the last 
character cell of the string (308,50). A horizontal character cell is 8 dots 
wide and 14 dots high, so in this example the current position has been 
updated in the horizontal direction by 208 dots (26 characters X 8 
dots). 

10 LINK 'graon' N LINK 'xaraph' I link to oraohic routines 

20 PRINT CHR%<27)i "Z2J" ! clear character plane 

30 ERAGRP(0%) \ GRPON \ P AN ( OX, 0/1 ) I erase & turn on grapfiics plane 

40 MOVE aOOV., 50"/.) 

30 LASEL {'This is a horizontal label'.OX. 1'/. ) 

The following is what appears on the display screen after the above 
program is run. 




8-35 






LABEL 

GRAPH.OBJ 




This BASIC program places a 24 character vertical string in the 
graphics plane. An initial MOVE changes the current position to 
300,10, the place where the bottom right corner dot of the first 
character cell of the string will be. LABEL updates the current position 
to the dot immediately above the top right corner of the last character 
cell of the string (300,202). A vertical character cell is 14 dots wide and 
8 dots high, so in this example the current position has been updated in 
the vertical direction by 192 dots (24 characters X 8 dots). 

lOLINK 'graph' ! limctographicroutines 

20 PRINT CHR®(27)5 ''C2J" ! clear character plane 

30 ERAGRP(07.) \ GRPON \ P AN ( 0%. 07. ) ) erase & turn on graphics plane 

40 MOVE (300%. 10%) 

50 LASEL('This is a vertical lab e 1 90%; I %) 



The following is what appears on the display screen after the above 
program is run. 
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LABEL 

GRAPH.OBJ 



xample 4 

This BASIC program shows how the label command causes the 
current pixel position to be updated so that strings can easily be 
concatenated. 



10 LINK 'graph ' '■ Unit 

20 PRINT CHR»(27); "C2J" ! clear 

30 ERA0RP(07.) \ ORPON \ PAN<OX, OX) ! era&e 
40 M0VEC2O0X/ 1207.) 

50 LA9EL( 'ABCDEFOHIJKLM', 07., 17.) ! some 

60 LA8EL< 'N0PQRSTUVWXY2 07., IX) 

70 M0VE(200X, lOOX; 

SO LABEL< 'ABCDEFGHIJKLHNOPQRSTUVWXYZ OX. IX) 



to graphic 
character 
& turn on 

label ing to 



routines 

plane 

graphics plane 
shouj concatenation 



The following is what appears on the display screen after the above 
program is run. 
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This BASIC program shows how the LABEL routine can access the 
alternate character set. 



10 LINK 'graph ' 

20 PRINT CHRl<27)i "C2J" ! clear character plane 

30 ERA0RP(07.) \ ORPON \ PAN< 0*/.. 07. > ! eraee U turn on graphics plane 

40 S0»-CHR$(14'.^) 

50 SI4-CHR»< 157.) 

60 MOVE< 150%. 130X) 

70 LA8£L( "String from primary character set“.0%»lX) 

80 MOVE (150%, 1107.) 

90 LABEL(SD®4-"String from alternate character set",0%, 1%) 

100 MOVE ( 1507., 90%) 

110 LABEL(‘‘from pr i mar y "•rSD*-»- " f r om al ternate f rom primary ", 0%, 1%) 



The following is what appears on the (iisplay screen after the above 
program is run. This output would be different if a customized (non- 
standard) character EPROM was being used. 
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Printing the Graphic Plane 



PRiNTJNG THE GRAPHICS PLANE 

A printed image of the display screen window into the graphics plane 
can be obtained by calling special routines from a BASIC or 
FORTRAN program. 

A printer must be attached to a 1722A RS-232port, KB l: or KB2:.The 
Epson FX® and RX® series, the Epson MX-IOO® with 

GRAFTRAX®, and the Tally® Model MT1605E are the supported 
printers. A routine is provided that allows flexibility in printing a 
screen on other printers or a special assembly language module can be 
written to support other printers. See the section “Printing the 
Graphics Plane on Unsupported Printers”. 

The Epson printers need to have the Epson Intelligent Serial 
Interface® card (Epson Cat. No. 8148) installed. The Epson is 
connected to the KBl: or KB2: port with Fluke printer cable Y1709. 
The Epson printer and Epson serial interface DIP switches should all 
be left in their factory default settings. Use the Set Utility program to 
establish the following parameters: 



KBl; br 19200 db 8 pb n si e so e to 10 
exit 



Tally® MTl 605Eprinter should be connected to the KBl; or KB2: port 
with Fluke printer cable Y1709. Ail DIP switches should be in the OFF 
position except switch 4 in the I/O panel, which should be ON. Use the 
set utility program to establish the following parameters; 

SET 

KBl; br 9600 db 8 p b n s 1 e so e to 10 
exit 



It is important to note that only the display screen window into the 
graphics plane is printed. The character plane is not printed. A 
convenient way to place characters in the graphics plane is provided by 
the graphics routine, LABEL. 



® Epson FX, RX, Epson MX-TOO, and GRAFTRAX are Registered Trademarks of Epson America, Inc. 
©Tally Is a Registered Trademark of Mannesmann Tally 




The Display 
Printing the Graphic Plane 



Graphics Print Routines 

The routines available to BASIC programs are recorded on the System 
disk in a file named GPRINT.OB.J, and in a library file named 
BASIC.LIB. FORTRAN programs access the graphics print routines 
by using the library file named FLUK22.LIB on the FORTRAN disk. 




The table that follows describes the graphics print routines. There are 
two differently named routines for each graphics print capability, one 
routine is called by a BASIC program and the other is called from 
FORTRAN. All FORTRAN routine names end in an F; BASIC 
routine names do not end in an F. All arguments are integers except 
that the first argument to GRBYTE and GRBYTF is an integer array 
name. 




GPOUT({chan #}, {printer type}) 
GPOUTF({unit #}, {printer type}, {error}) 

GPRINT 

GPRNTF({error}) 

GRBYTE({array},{slice},{bit order}) 
GRBYTF({array}, {slice}, {order}, {error}) 




designate serial port to which to 
send screen and specify printer type 

perform screen dump to printer 

read screen slice and store in 
array 



In the pages that follow, each of the BASIC routines is described in 
detail. Program examples are provided as they would appear in 
programs written for the BASIC Interpreter. Error numbers given are 
those that BASIC reports. The corresponding FORTRAN routines 
are described in the FORTRAN manual. 
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GPOUT 

GPRINT.OBJ 



Usage 

GPOUT( {channel number}, (printer type}) 



Description 

This routine designates a channel for the graphics screen data and the 
type of printer that is used. This routine must be called before calling 
the GPRINT routine. The GPRINT routine does the screen dumping 
and GPOUT is called to prepare for printing. 



channel number An integer between 1 and 16 that corresponds to a 
channel number specified in a previous OPEN 
statement. The OPEN statement must have assigned 
a channel to KBl: or KB2:. 



printer type An integer between 0 and n that specifies what type 
of printer is to be used for the graphics dump. 



Printer Type 


Printer 


0% 




Epson FX series 


1% 




Epson RX series 


2% 




Epson MX-100 with Graftrax 


3% 




Tally MT1605E 


4% ^ 


I 


for user-defined printer types (See Printing 


I I 

; I 




the Graphics Plane on Unsupported 


n% J 


I 


Printers section) 



rrors 

302 - Illegal channel number 
308 - Channel is not open 
2001 - Undefined printer type 



Example 

This BASIC program excerpt specifies that the screen to be printed on 
is an Epson FX printer that is connected to the KB I: port. 

40 OPEN "KBl : “ AS NEW FILE 3 ! assign channel 5 to KBl: 

30 GPOUT (57.. 0*/. ) ! data to channel 5 & Epson FX printer 
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GPRINT 

GPRINT.OBJ 



Usage 

GPRINT 



Description 

This routine causes the display screen window into the graphics plane 
to be dumped to a printer. Any images in the character plane are 
ignored. The BASIC statement after the call to GPRINT is executed 
when the printing has finished or when an error has been detected. 

Almost ail input from the keyboard or touch sensitive display is 
ignored until printing is done or an error is detected. Inputs that are not 
ignored during the operation of GPRINT are <CTRL>/P, 
(CTRL) /C, and the ABORT button. Any of these cause GPRINT to 
stop, but they have different effects than in a normal BASIC program. 
These effects are: 

n If GPRINT is called from the BASIC Interpreter, (CTRL) / C, or 
the ABORT button will cause processing to resume at the next 
BASIC statement. If (CTRL) / P is done while in character mode 
(SET NOECHO), control passes to the statement after the 
GPRINT call. In line mode, (CTRL) /P causes an exit to FDOS. 

□ If GPRINT is called from compiled BASIC while in character 
mode or line mode, (CTRD/P, (CTRL)/C, and the ABORT 
button will cause an exit to FDOS. 

□ The BASIC ‘ON CTRL/C GOTO ...’ statement has no effect 
during GPRINT execution. This means that while a GPRINT is in 
operation (CTRD/C, the ABORT button, and possibly 
(CTRD/P will not be trapped as they normally would be, 



rrors 

311 - Non-recoverable device read/ write error (timeout) 

2002 - GPOUT not called yet 

2003 - Printer timeout 

2004 - KBO: is not the console device (a switch has been performed) 
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GPRINT 




1. Pressing the ABORT button during GPRINT can cause 
BASIC error 31 1 (N on-recoverable device read/ write error). A 
(CTRL) / S done before or during GPRINT will always cause 
a 3 1 1 error. 

2. If (CTRL) /P is done during a GPRINT, it may be necessary 
to power the printer off and on. This is to avoid extraneous 
data to be printed at the start of a subsequent screen print. 



This BASIC program draws a picture and prints it on an Epson MX- 
100 printer. 



10 LINK 'gprint ' 

20 PRINT CHRSi:27)i "C2J" 

30 ERAGRP<0%) \ GRPQN 
40 MOVE { 250%, aO“/C) 

50 PL0TR(6OX, 607.. -i%) 

60 PLQTR<607.. -60%, ~17.) 

70 PLQTR(-1207„ 0%. -17.) 

SO' 

'='0 OPEN "KBl: ’* AS NEW FILE 4 
100 GP0UT(47., 27.) 

110 GPRINT 
120 CLOSE 4 



link to graphic print routines 

clear character plane 

erase & turn on graphics plans 

draw a picture 



assign channel 4 to KBl: 

data to channel 4 & an Epson MX— 100 

print graphics plan® 
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GRBYTE 

GPRINT.OBJ 

Usage 

GRBYTE({array address}, {slice number}, (slice row order}) 

Description 

This routine fills an array with a “slice” of the display screen. Any 
images residing in the character plane are ignored. This routine can be 
used for printers not supported by the GPR !NT routine, or for saving a 
screen image file to print later. 

Parameters 



array address This is the starting address of a 640 element integer 
array. This array must be a main memory array; it 
can not be a virtual array. The first address of the 
array is specified by the array name followed by left 
and right parentheses, for example A%(). The 
program can fail if the array does not contain at least 
640 elements. 

slice number An integer 0 through 27 which corresponds to an 
eight dot high horizontal section of the display 
screen. The following figure shows what is meant by 
a “slice” of the screen and how the slices are 
numbered. 






GRBYTE 

GPRINT.OBJ 

An integer that specifies the order in which the bits 
in each column of a slice are placed into the array. If 
this argument is 0, the bottom row of a slice is placed 
in the least significant bit of an array element. If the 
argument is any other value, the top row of a slice is 
placed in the least significant bit of an array element. 
This argument is provided because of different 
printer model conventions in addressing the print 
head pins. 

The GRBYTE routine takes a slice of the display screen and places the 
information in the least significant bytes of the user’s array. If a dot 
location is on (illuminated), then the bit in the array corresponding to 
that dot location is a 1. The following figures show how a slice of the 
screen is placed into the user’s array when the ‘slice row order’ 
argument is 0. 



slice row 
order 



SLICE TO ARRAY CORRESPONDENCE 

Column 




640 dots H 



8-46 




GRBYTE 
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The following figure shows how a slice of the screen is entered into the user’s 
array when the “slice row order” argument is not 0. 



USER ARRAY WHEN SLICE ROW ORDER ARGUMENT IS NOT 0 



Word 



Slice Column 






GRBYTE 



GPRINT-OBJ 

Errors 

311 " Non-recoverable device read/ write error (timeout) 

2004 - KBO: is not the console device (a switch has been performed) 

2005 - Slice number not in 0 to 27 range 



Pressing the ABORT button during GRBYTE can sometimes cause 
BASIC error 311 (Non-recoverable device read/ write error). A 
<CTRL>/S done before or during GRBYTE will always cause a 311 
error. 




This BASIC program draws a picture and prints it on an Epson FX 
printer using an IEEE port. The program assumes that the Epson’s 
IEEE interface card has been set to device address 6. 



10 LI NW 'gDT’int'’ ' 

20 ERAGRP?0%> \ GRPON \ PAN<0%- 07.) 

30 MDVE(07.« 07.) 

40 PL0TR(O7., 2237.< 17.) ! 

50 PL0TR<639%. OX, 1%) 

60 PLDTR(OX, -2237.. 1%) 

70 PL0TR(-6397., 07., 1%) 

80 DIM AX(6407.) ! 

90 PRINT @6.CHRS<27)i 'AOCHRS(8>i ! 

100 FOR SX = 07, TO 277. 

110 GRBYTE(A7.( ) . S7., OX) ! 

120 PRINT @6,CHR«<27)i ' » ' ; CHR« ( 6 ) i ! 
130 PRINT ®6, CHRS< 128)i CHR*<2)i ! 

140 FDR IX » OX TO 6397. 

ISO PRINT @6, CHR*(AX( IX) ) i ! 

160 NEXT IX 

170 PRINT @6 ! 

180 NEXT SX 



link to graphic print routines 
drauj a picture 

arrag for a screen 'slice' 

send code for printer line spacing 

a slice of screen to array A 
send required code to put Epson FX 
in graphics mode 

send 8 dot column of slice to printer 
carriage return 




Unsupported Printers 



PRINTING THE GRAPHICS PLANE ON UNSUPPORTED 
PRINTERS 

The printers supported by the GPOUT and GPRINT routines are the 
Epson FX and RX, the Epson MX-lOO with GRAFTRAX, and the 
Tally MT1605E. There are two different ways to print the graphics 
screen data on other printers. 

1. The easiest method of printing the screen on various printers is 
to use the GRBYTE routine. Flexibility to drive different 
printers is achieved by making multiple calls to the GRBYTE 
routine from a BASIC program and using the BASIC PRINT 
statement. The GRBYTE routine retrieves the screen data and 
the PRINT statement sends the screen data to a printer. See the 
previous section that describes the GRBYTE routine. 



10 LINK 'gprint ' \ LINK 'graph ' i 
20 ERAGRPIDX) \ QRPQN \ PAN(B%, 07.) 
30 M0VE<O%, 07) 

40 PLDTR (07.> 2237, 17.) ! 

50 PL0TR<6397, OZ, 17) 

60 PLOTR (07, -2237, 17.) 

70 PLDTR (-6397, 07, 17) 

80 DIH A7(6407) 

90 OPEN “'KBI:" AS NEW FILE 2 ! 

100 PRINT #2, CHR»(27) ; 'T14'; ! 

no FOR S% = 07 TO 277 
120 eRBYTE(A7(). S7., 17) i 

130 PRINT #2.CHRS<27); 'S00640'J ! 

140 FOR 1% = 07 TO 6397 
150 PRINT »2. CHR*(A%(I7) ); ! 

160 NEXT 17. 

170 PRINT #2 ! 

180 NEXT S7 
190 CLOSE i 



link to graphic print routines 
draw a picture 

assign channel 2 to KBl: 

send code for printer line spacing 

a slice of screen to arrag A 

put Prowriter M8S10B in graphics mode 

send 8 dot column of slice to printer 

carriage return 



Prowriter Model M8510B is a Registerec Trademark of C. Itoh Electronics, Inc. 




Unsupported Printers 



2. Another method of printing on an unsupported printer is to 
create an Assembly Language routine and tables modeled after 
the assembly routines and tables for the supported printers. 
These printer driver routines and tables are recorded on the 
Assembly disk (Option 17XXA-201) in a file named 
PRDRIV.PRE. 

A new printer type value to be specified in the GPOUT routine 
is defined by supplying a new entry in the file named 
PTYPE.PRE. The Assembly disk has an image of this 
Assembly Language source file. 

By writing new routines and tables in PRDRIV.PRE and 
making the appropriate entry in PTYPE.PRE, a BASIC 
program only needs to call GPOUT and GPRINT to print the 
display screen. 



The steps to be taken and excerpts from the above mentioned 
Assembly Language source are as follows: 



a. Add a new printer type value and entry point name in 
PTYPE.PRE. The following is the entire source of 




Unsupported Printers 



b. Add a def statement for the new printer driver entry point 
at the start of PRDRIV.PRE 

c. Add a new module in PRDRIV.PRE that references a new 
printer dependency table. The following is the module for 
the Epson FX printer. 



» 

* moduls: 



* function; 

» 

* called via: 
» 



opsonf 

To send graphics screen data to the Epson FX or RX printer 
bl from GPRINT 

<all registers available except rJl) 



epsonf sou 
c fr 

* if 

1 i 
mov 

«• endlf 

b 



S i entry point 

r i ; 

Sslicen eqw rl ilf at 1st screen slice 

rl.epfdat ; get Epson FX & RX printer dependencies table 

r 1 < eprdp tb i 

I end if 

©driver j go to common printer driver 



d. Create a printer dependency table in PRDRIV.PRE. Most 
entries in this table are pointers to other tables that contain 
the character sequences required by a particular printer. 
The third entry in this table is the time in 10 millisecond 
ticks that it takes for the printer to print its data buffer. 
This entry is required for handling CTRL /C and the 
ABORT button correctly. The order of entries within this 
printer dependency table is very important. Use the 
following table for the Epson FX printer as a guide. 



« 

« 

tpf dat 



Epson FX & RX dependancy tabl 



data ap s tch ; row start characters table address 

data ©pstln i row start characters table length 

data 200 ; delay in lOms ticks for during printing 

data ep term ; termination characters table address 

data epterl i termination characters table length 

data 0 i nui 1 to mark end of this table 



e. Create the tables containing the character sequences that 
are required to put the printer in dot graphics mode. The 
following are tables used by the Epson FX printer driver. 



epstch 



apstln 

* 

ep term 
epterl 



.Epson FX & RX row start characters 
I 'ESC A 8' sets line feed specing to 8/73'* 



'ESC » 6 128 2' graphics (90dpi) 640 dot row 

e^u »-epstch 

even 

byte 27 ) Epson FX. RX, MX-lOO screen dump term characters 

byte '® ' i 'ESC « ' master reset for Epson (power up state) 

equ ♦-epterm 



byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 



27 

'A' 

8 

27 
' * ' 
6 

128 

2 
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f. Assemble the modified PTYPE.PRE and PRDRIV.PRE. 
Create a new GPRINT.OBJ file by issuing the following 
Linkage Editor commands. The files PRINT.OBJ and 
FSRGMY.OBJ that are referenced in these LE commands 
are also provided on the Assembly disk. 



le sprint. obj 
task gprint 
form ascii 
part 

incl print. prdrivi ptype. f«rgmg 
end 



Call the GPOUT routine in a BASIC program with the 
new printer type value and then call the GPRINT routine. 




Graphics Routines 



CLUS80N 

This section has described the many features of the 1 722A display. The 
display is specifically designed for ease of use by both the programmer 
and the operator. While maintaining compatibility with the display 
capabilities of its predecessor, the 1720A Controller, the I722A 
incorporates a greatly expanded set of graphics and display-control 
features. 

Taken as a whole, the 1722A boasts one of the most comprehensive 
display packages in the instrumentation industry. When the 
possibilities of the software are combined with the unique touch- 
sensitive screen, the result is a powerful set oftools for the programmer 
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-006/-007 Memory Expansion Modules 9-29 



-008 IEEE-488/ RS-232 Interface 9-33 

-009 Dual Serial Interface 9-37 

1760A and 176IA Disk Drive Systems 9-55 

1765A Winchester Disk Drive System 9-63 
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This section of the manual gathers into one area all information about 
options available at the time of printing. Because new options are 
always being investigated and released throughout the life of the 
instrument, this section is expected to grow between printings of the 
manual. 

When a new option becomes available, first shipments are supported 
by “User information” sheets, which can be incorporated into this 
section after the option is installed. The next printing of the manual 
will then include the new sheets in this section. Be sure to contact your 
local Fluke representative for the latest information about available 
options. 

The items discussed in this section are not included in the shipment 
unless ordered at the same time as the Controller. If specified on the 
order, options will be installed at the factory. Otherwise, they may be 





PERIPHERALS 

All the peripherals listed here are separate products, and can be 
ordered by the model numbers shown. 

1760A Disk Drive System, 400K Byte 

176! A Dual Disk Drive System, 800K Byte 

1765A/AB Winchester Disk Drive, lOM Byte 

1 780 A InfoTouch Display 
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Y1700 Keyboard 

Y1706 Ten-pack of Blank Unformatted floppy disks (Certified) 
P/N 533547 

Pad of 50 Programmers Worksheets 



Y1711 Reinforced Shipping Case 

Y8021 Shielded, I meter 
Y8022 Shielded, 2 meters 
Y8023 Shileded, 4 meters 



Standard (For DCE devices) 
Y1707 2 meter 
Y1708 10 meter 



Null Modem (For other DTE devices) 
Y1702 2 meter 
Y1703 4 meter 
Y1705 0.3 meter 



e 



For connecting a serial printer. 
Y1709 2 meter 



Mount Kits 

YI790 Rack Mount Kit with 24-inch slides 
Y1794 Rack Mount Kit with 18-inch slides 

Carrying Handie 



Y1795 




Options 



oPTiom 

Options are listed by a unique three-digit number appended to the 
product family identifier. For example, the -004 option 256K Byte 
Bubble Memory option is ordered using model number 17XXA-004. 



Memory Expansion options greatly increase the available on-line 
storage capabilitites of the Controller. Memory Expansion Modules 
can be placed in any of the five unused options slots in the card cage. 
The maximum dynamic RAM configuration increases the total on-line 
system memory to about 2.6 Megabytes; Bubble Memory can provide 
up to approximately 1 .3 Megabytes. Combinations are possible; please 
consult the Option Configuration Table later in this section for 
complete details. 



-004 256K Byte Bubble Memory 
-005 512 Kbyte Bubble Memory 
-006 256 Kbyte RAM Expansion 
-007 512 Kbyte RAM Expansion 



nterface Additions 

Interface options expand the Input/Output possibilities of the 
Controller. They may only be used in card cage slots 1, 3, and 5. 




Configuration Information 

Use this table to determine allowable configurations of available 
hardware options. A dot in a column indicates the slots that the option 
can be placed in. For example, if all available slots are used for 512K 
byte RAM expansion memory modules, the system has the maximum 
memory configuration for this type of memory: 2.6 M bytes, but no 
slots are available for other modules. On the other hand, slots 1, 3, 4, 
and 6 could be used for additional memory, resulting in 2. 1 M bytes of 
additonal memory, and slot 5 would still be available for one of the 1/ O 
options. 
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OPTIONS 




■oftware 

For increased flexibility, these software options are available to allow 
programming the Controller in languages other than Interpreted 
BASIC, which is supplied as the standard programming language. 
Each language option is supplied as a floppy disk with an 
accompanying Programming manual 



-201 Assembly Language Software Development System 
-202 FORTRAN Software Development System 
-203 Compiled BASIC Software Development System 
-205 Extended BASIC Software Development System 






This information is provided to assist you in installing hardware 
options into a 1722A Instrument Controller. All options are installed 
in the same way. The instructions here describe how to install options 
into the Controller’s card cage, and give general directions on how to 
check them out. 



Some of the options require some initial set-up. Be sure to refer to the 
appropriate option User Information for a module’s unique 
requirements before you start the installation. 

If a new module fails to perform correctly on first applying power, be 
sure to recheck your work. It may be that a small but important step 
was missed, resulting in a failure of the new module to operate. 



MSTALLATtON CHECKOUT 

Inspect the shipping carton for damage, and notify the shipper 
immediately if it appears to have been damaged. Unwrap the module 
and inspect it for damage. If everything seems to be in order, set any 
selection switches or jumpers that are unique to the module. This 
information is available in the individual sections that cover each of the 
options. 
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User Information 
Instailing Hardware Options 

INSTALLATION 

1. Refer to the option User Information provided with the 
module and perform any preliminary set-up steps. 

2. Power down the Controller, and remove the AC line cord. 

3. Remove the rear card cage cover, illustrated below. Depending 
on which modules are already installed, more screws than 
those indicated may also have to be removed. The 6 screws 
shown here are those that are removed from a new Controller 
with no options installed. 




4. Determine which location to use for the option: 

Memory Options: Any open slot 

17XX-008 Option: Slot 5 only 

Other Input Output Options: Slots 1, 3, or 5 only 




User Information 
nstalling Hardware Options 



5. Carefully slide the option module into the card cage. Make 
sure the module is fully seated in the card cage so that it makes 
solid contact with the card-edge connector. 




6. If an input/ output option is being installed, remove the two 
screws holding the solid oval plate onto the card cage cover. 
After reinstalling the card cage cover, use the two screws to 
attach the shield plate supplied with the option, to the card 
cage cover. Afix the identification sticker to the outlined area 
on the card cage cover. 
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User Information 
Installing Hardware Options 



7. Reinstall the power cord. 

8. Once installation is complete, power up the Controller and test 
the module. Refer once again to the option User Information 
provided with the module for any special requirements or 
procedures. 

9. In case of problems with any new option, recheck your work to 
insure that switches are set properly, and that the correct 
jumpers are in place. Be sure that the board is fully seated in the 
card cage. If everything is in order, but the failure continues, 
refer to Appendix G, System Diagnostics, for troubleshooting 
information, or call your local Fluke Service Center. 
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The Option 17XXA-O02 Parallel Interface (PIB) is an extremely 
versatile addition to the Fluke Instrument Controller. The PIB has the 
built-in ability to adapt to some of the most unusual interface 
requirements of connected devices. 




Parallel Interface Board 



Option Contents 

The photograph and table below show the contents of the 17XXA-002 
option. The floppy disk is supplied to support the PIB in 1720A 
installations. For the I722A Controller, the PIB support software is 
supplied on the standard system disk. With minor variations, which 
are fully explained in the manual, both sets of routines operate the 
same. 



17XXA-002 PARALLEL INTERFACE OPTION CONTENTS 



NUMBER 


ITEM 


JOHN FLUKE PART NUMBER 


1 


Parallel Interface Module 


611947 


2 


Instruction Manual 


732230 


3 


(2) Parallel Interface Cables 


733907 


4 


1720A PIB Software Disk 


630699 
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The instructions that follow describe how to install a Parallel Interface 
option in a 1722 A Instrument Controller. 



Configuration Procedure 

The operating configuration of the Parallel Interface is set up by a 
board address switch on the module. 



1. Set the address switch for ports PIO and PIl. Use the table 
below to ensure that the switch is set properly for port 
addressability. 



SWITCH/ADDRESS OPERATING CONFIGURATION 



BOARD 


SW4 


SW3 


SW2 


SW1 


PORT 

PIO 


ADDRESS 

PHRANGE 


ADDRESS 


1 




I ON 


ON 


ON 


0 


1 


F340-F346 


2 




I ON 


ON 


OFF 


2 


3 


F348-F34E 


3 


/7T'0 


ON 


OFF 


ON 


4 


5 


F350-F356 


4 




ON 


OFF 


OFF 


6 


7 


F358-F35E 


5 




OFF 


ON 


ON 


8 


9 


F360-F366 


6 




OFF 


ON 


OFF 


10 


11 


F368-F36E 


7 




OFF 


OFF 


ON 


12 


13 


F370-F376 


8 




OFF 


OFF 


OFF 


14 


15 


F378-F37E 



2. Once the switch has been set, use the directions in the Options 
section “Installing Hardware Options” to install the -002 
option into the I722A. 

3. Power up the Controller and test the new interface by using the 
System Diagnostic software. Appendix G of the System Guide 
explains how to use the System Diagnostic software to test the - 
002 option. 

4. In case of problems with the new module, recheck your work to 
ensure that the board is fully seated in the card cage, and that 
port connectors are attached securely. If everything is in order 
but the failure continues, refer to Appendix G for 
troubleshooting information, or call your local Fluke Service 
Center. The Parallel Interface module is included in Fluke’s 
Module Exchange Program. 
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SOFTWARE COMPATIBILITY 

For the I722A Instrument Controller, the Parallel Interface software is 
supplied on the 1722A System Disk. These machine language 
programs are interdependent and are compatible only in the 
combinations of versions supplied by Fluke and documented in 
published Fluke manuals. Using incompatible system software 
modules may give unpredictable results. In this case, Fluke cannot 
provide software support except for identification of compatible 
combinations. 



NOTE 

The floppy disk supplied with the Parallel Interface option 
contains software for operating the interface when it is 
installed in a 1720 A Instrument Controller ONLY. The same 
routines for the 1722 A Controller are already supplied on the 
System Disk that is shipped with the instrument. 
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User Information 

Parallel Interface Board 



NTERFACE DESCRIPTION 

The port lines provide bidirectional data transmission between the 
Instrument Controller and compatible external devices. The drawing 
below shows the cable connector and lists the signal definition and 
logic states for each of the lines at the interface. 




PIN 


MNEMONIC 


WIRE COLOR 


DIRECTION 


I 


Shield 


Girjund' 




2 


DP(13) 


Red 


- 


3 


DP|8) 


Yellow 




4 


DP(m 


Green 




5 


DP(10) 


Vtoiei 


-- 


6 


DP(9( 


Grey 


.. - 


7 


DF’Ci) 


Red vyhiie 


- - 


3 


DP(7( 


YeMow White 


. .. 


9 


DP(6i 


Groon While 


- .. 


rC 


DP(5) 


Violet VYh.tO 


- - 


M 


DPfOl 


Grev wriiie 


. - 


r2 


DP(3) 


Yellow Fteo 


- . 


■3 


DP(2) 


Green/Ped 


- - 


14 


DP(14) 


Violei'Red 




15 


DP(15) 


Grey Red 




16 


DP(l2l 


Rea.-G'pen 


- . 


17 


RETURN 


Red<Biack 




tg 


RETURN 


Yellow Black 




19 


RETURN 


Green Black 




20 


RETURN 


Vioiet Black 




21 


PFLG 


Red Grey 




22 


PlOE- 


Yeilow.'Grey 


— 


23 


PCTRL 


GreervGrey 


— 


24 


PQIR 


Violet Grey 


- 


25 


DP(li 


Gray. Green 


— 



■Pir. ) is connected to the cabie shieid 'his pm is not a 
reference poms lor signals its purpose is to connect me 
cable shield so a systom ground Make sure tnai use of this 
connection does not resell .rt circular grounding paths 
(loops) through ihe system Such ground loops can conouci 
ertough curiorii to miortere wiin data iransinission 

.^^irtdicales bidirectiona! data lines 
•— indicates input to PIB 
-•indicates output by PIB 
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Port Signals 

On the Parallel Interface module, several signals control the direction 
of data and the sense of the handshake lines. These signals are defined 
in the table below. The jumpers shown on the port schematic permit 
inverting handshakes. 



PORT SIGNAL DEFINITIONS 



SIGNAL NAME 


DIRECTION 


DEFINITION 


PDIR 


Output 


Port Direction: Direction of data on port. 


POE 


Input 


Port Output Enable: Used by external device to 
disable the output from the ports. 


PFLG 


Input 


Port Flag: One of the two handshake lines; this 
signal originates with the peripheral device. For 
input operations (device to port), PFLG, when 
asserted, indicates that input data is valid. For 
output operations, PFLG, when asserted, 
acknowledges that the device is reading the output 
data from the port. 


PCTRL 


Output 


Port Control: The other handshake line; the signal 
originates with the Parallel interface module. For 
output operations (port to external device), 
PCTRL, when asserted, indicates that the output 
data is valid and the device may read it. For input 
operations, PCTRL, when asserted, indicates that 
the port is reading the incoming data from the 
device. 


Data 


Bidirectional 


Each data line can be used either as an input or 
as an output. 
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OFTWARE LIBRARY (PIBLIB.OBJ) 

The next few pages summarize the available software routines. The 
parameters are described immediately following the descriptions of the 
routines. 



CHKBIT 




Check bit 
port, bit, bool 

This routine checks a particular bit on a Parallel 
Interface Port. It is equivalent to reading the port and 
then isolating the specified bit position. 




CLRBIT Clear bit 



Parameters: port, bit 

Description: This routine clears to zero a particular bit on a selected 
port. It is equivalent to reading the port, ANDing the 
bit with 0 in the appropriate position, and then writing 
the data word back out to the port. 



SETBIT Set bit 
Parameters: port, bit 

Description: This routine sets a particular bit (output = high) on a 
selected port. It is equivalent to reading the data 
latched at the port, ORing the bit in the specified 
position with I, and then writing the data word back 
out to the port. 



RDWORD Read word 
Parameters: port, word 

Description: This routine reads a selected port and writes the value 
into a variable. 
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WTWORD Write word 

Parameters: port, word 

Description: This routine writes a word from a variable to a 
specified port. 



RDBLK Read block 
Parameters: port, block, count 

Description: This routine reads multiple words from a port into an 
array. 



Parameters: port, block, count 

Description: This routine writes multiple words to a port from an 
array. 



Parameters: 



Description: 



Fast Read block 
port, block, count 

This routine reads a block of data from a port, as fast as 
possible. It does not perform the error checking that is 
done in a normal read of a block using RDBLK. 



FWTBLK Fast Write block 
Parameters: port, block, count 

Description: This routine writes a block of data to a port as fast as 
possible. It does not perform the error checking that is 
done in a normal block write using WTBLK. 



9-21 




User Information 
Parallel Interface Board 



POPEN Open a port 

Parameters: port, mode, mask, timeout 

Description: POPEN opens a port in preparation for data transfer 
at the interface. 

PCLOSE Close a port 

Parameters: port 

Description; PCLOSE closes the specified port and returns the 
hardware to a passive state similar to the power-up 
condition. 
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rameters 

When the routines are used in a program, one or more parameters are 
specified by the programmer. All parameters must be specified as 
integers. 

PORT The port number for the routine to operate on, 

expressed as an integer in the range 0 » 15. 

MODE The Parallel interface module operates in one of 

four modes: No Handshake, Full Handshake, 
and Strobe Input and Output Handshakes. With 
the exception of No Handshake, the handshakes 
synchronize incoming and outgoing data. The 
table below lists the handshake names and the 
mode number that the software recognizes. 



HANDSHAKE MODES 



NAME 


DEFINITION 


MODE 


— 


No Handshake 


0 


HNDSHKIN 


Full Handshake Input 


1 


STROBEiN 


Strobe Input 


1 


HNDSHKOUT 


Full Handshake Output 


2 


STROBEOUT 


Strobe Output 


3 



TIME OUT The wait time before an incomplete handshake is 

terminated. 



BIT The bit number to be checked, read, or written to, 

expressed as an integer. 

BOOL When a bit or word is read or checked, as in the 

CHKBIT routine, the routine places a value into 
the variable specified as BOOL. 

DIRECTION An integer that indicates the desired transmission 
MASK direction of each bit on the port. 
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BLOCK This parameter is the array to which data will be 

transferred using the Block subroutines RDBLK, 
WRTBLK, FRDBLK, and FWTBLK. 

COUNT Indicates how many array elements to transfer. 



This information has been taken from the manual supplied with the 
PIB. Besides being the definitive source of information about the 
topics presented here, the PIB manual includes a great deal more 
information, including: 

□ Specifications 

o Interface timing 

□ Sample programs 

□ Performance Testing 

□ Theory of Operation 
n 



Schematic 




The Option i7XXA-^04/-005 Bubble Memory Modules provide 
additional memory for the 1722A. 



Like a floppy disk, the Bubble Memory is treated by FDOS as a file- 
structured device. Information is retained in the device when the power 
is turned off. 

The 17XXA-004 Bubble Memory Module contains 256K bytes of 
memory; the I7XXA-005 module contains 5 12K bytes. The maximum 
amount that can be installed in a system is 1.5M bytes (any 
combination of three modules). 
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Inspect the shipping carton for damage. Notify the shipper 
immediately if the carton appears to have been damaged in shipping. 
Unwrap the module and inspect it for damage. If everything seems to 
be in order, go on to the next step, setting the board’s address switch. 



oard Addressing 

In order for the Operating System (FDOS) to operate properly using 
bubble memory, there must be a unique address associated with each 
Bubble Memory Module installed. Use the drawing below to locate the 
board address switch (SWl). 




The 1722A has five slots available for options. Bubble Memory 
Modules can be installed into any three of them. The SWl address 
switch settings determine the device names, and are identical for 
Option -004 (256K bytes) or Option -005 {512K bytes). 
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1 . Once address switch S W 1 has been set, follow the directions in 
the Options Section “Installing Hardware Options” to install 
the module into the Controller’s card cage. Be sure to turn the 
power off before beginning. 



2. Power up the Controller and insert the 1 722A System Software 
disk. If required, use the System Generation Utility program 
(SYSGEN) to make a new System Software disk that includes 
the Bubble Memory driver. Refer to Section 3 of the System 
Guide for instructions. 



3. When a new System Disk has been generated, press the 
RESTART button and let the disk load the new FDOS. 

4. Use the File Utility Program (FUP) to format the Bubble 
Memory Module. Type MBx; / F, where x is the device number 
given the module by its address switch setting. See Section 4 of 
the System Guide for complete details about using FUP. 



5. Test the new memory board by running the Bubble Memory 
diagnostic, as described in Appendix G, “System Diagnostic 
Software”, or by transferring files to and from the bubble 
memory device using FUP. 

6. If the diagnostic test executes successfully, your Bubble 
Memory Module is now available for use. 

7. If any trouble develops, first make sure that the address 
selection switch is set properly, and that the module is seated 
firmly in the card cage. If everything seems to be in order, but 
the failure continues, refer to Appendix G, “System Diagnostic 
Software”, or call your Fluke Technical Service Center for 
assistance in tracking down the problem. The Bubble Memory 
Module is included in Fluke’s Module Exchange Program. 







INTBODyCTION 

The Option I7XX-006/007 Memory Expansion Modules provide 
additional memory for the 1722A. This added memory can also be 
configured as Electronic disk. 

The Operating System treats memory configured as E-Disk as an 
electronic version of a floppy disk. This means that files are stored and 
retrieved from E-Disk in a formatted fashion like a floppy disk. See the 
File Utility Program in Section 4 of the System Guide for instructions 
on how to configure E-Disk space. 

The 17XX-006 Memory Expansion Module contains 256K bytes of 
dynamic RAM; the 17XX-007 niodule contains 512K bytes. Any 
combination of up to five modules can be installed in a 1 722A at a time. 
If all of the slots are filled with 17XX-007 boards, then the total 
expansion memory added to the 1722A would be over 2.6M bytes. 
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Memory Expansion Module 



Board 



^STALLATfON CHECKOUT 

Inspect the shipping carton for damage. Notify the shipper 
immediately if the carton appears to have been damaged in shipping. 
Unwrap the module and inspect it for damage. If everything seems to 
be in order, go on to the next step, setting the board‘s address switch. 

Addressing 

In order for the Operating System to operate properly using expanded 
memory, each memory board installed must have unique addresses set. 
Each module has a memory switch, located in the drawing below. 
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The 1722A has five slots available for options. Expansion memory 
modules can be installed into any or all of them. To assure proper 
operation of diagnostics, the first module added should be given the 
address for Unit One as shown in the table below. Subsequently added 
modules are given addresses in ascending unit number order. The SWI 
address switch settings shown below are identical for Option -006 
(256K bytes) or Option -007 (512K bytes). 



jH 




HBB3S 




1 


2 




4 


1 




off 




off 


on 


2 




off 




on 


on 


3 




off 




off 


on 


4 




off 


on 


on 


on 


5 




on 


off 


off 


on 



2) Although the Controller may operate properly with 
addresses set out of order, setting them in the recommended 
order ensures that diagnostic software can correctly identify 
faulty components, and will prevent possible bus contention 
problems when mixing -006 and -007 options. 



Kample: 

Two -007 Options, and two -006 Options are to be installed. In this 
case, we will set the addresses for the larger memory sizes first by 
setting their switches to iUO and 1100. Next, the first -006 option’s 
switches are set to 1010, and the second one to 1000. 

These settings leave a 256K byte gap between the memory addresses 
occupied by the -006 modules. This gap is transparent when the 
module is in use. 
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iNSTALLATIOM AND CHECKOUT 

1. Follow the directions in the Options Section titled “Installing 
Hardware Options” to install the module into the Controller’s 
card cage. Be sure to turn the power off. 

2. To check the new memory module, power up the system and 
load the Operating System software. Observe the amount of 
memory message that appears when FDOS loads. It should 
indicate the additional memory that is now available, both in 
bytes and blocks. (1 block ==512 bytes.) 

3. To exercise the new memory, use the File Utility Program to 
configure all available free blocks as E-Disk, then transfer a 
large amount of files to the E-Disk, and see that they can be 
read to the screen. If everything is in order, this is an adequate 
check that the Memory Expansion Module is operational. 
Section 4 of the 1722A System Guide, Devices and Files, 
explains all the operations of the File Utility Program. 

4. If any trouble develops, first recheck your work. Make sure 
that the address selection switches are set properly, and that the 
module is properly seated into the connector on the 
motherboard. If everything seems to be in order, refer to 
Appendix G, System Diagnostics, or call your Fluke Technical 
Service Center for assistance in tracking down the trouble. The 
Memory Expansion module is included in Fluke’s Module 
Exchange Program. 





iNTROOUCTION 

This section of the 1722A System Guide covers the Option I7XXA-008 
IEEE-488/ RS-232 Interface Module. The module provides the I722A 
Instrument Controller with one additional IEEE488 port, and one 
additional RS-232 port. 

As shipped, the standard 1722A Instrument Controller has a single 
I EEE488 port and one RS-232 port. The 1EEE488 port has the device 
name GPO: when used as a serial device (output only), and Port 0 when 
used by a program as an instrument port. The standard configuration 
RS-232 port has the device name KBI:. 

The IEEE488 port on the -008 option has the device name GPl: or 
Port I, and the RS-232 port has the device name KB2:. See Section 4 of 
the System Guide for more information on devices. 
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Inspect the shipping carton for damage. Notify the shipper 
immediately if the carton appears to have been damaged in shipping. 
Unwrap the module and inspect it for damage. If everything seems to 
be in order, go on to the next step, Installation. 



TALLATiON 

1 . Refer to the drawing below to locate and set the configuration 
switches. The initial setup establishes the module’s IEEE-488 
address as 0, and its function as “system controller”. This 
switch setting also sets the RS-232 port to 4800 baud for power 
up, but the baud rate can easily be changed later using the Set 
Utility Program. See Section 5 of the System Guide for details. 



NOTE 

Both the standard IEEE-488 port and the one added by the - 
008 option can be set up as “system controller”, because the 
two ports are effectively two separate systems. However, if 
both of them will be connected to the same bus, then one of the 
ports must be set up as “idle controller”. 
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2. Once the switch has been set, use the directions in the Options 
section “Installing Hardware Options” to install the -008 
option into the 1722A. 

3. Power up the Controller and test the new interface by using the 
System Diagnostic software. Appendix G of the System Guide 
explains how to use the System Diagnostic software to test the - 
008 option. 

4. In case of problems with the new module, recheck your work to 
ensure that the board is fully seated in the card cage, and that 
port connectors are attached securely. If everything is in order 
but the failure continues, refer to Appendix G for 
troubleshooting information, or call your local Fluke Service 
Center. The IEEE-488 / RS-232 Interface module is included in 
Fluke’s Module Exchange Program. 




INTRODUCTION 

The 17XXA-009 Dual Serial Interface (DSI) provides the 1722A 
Instrument Controller with two additional serial communications 
ports. The ports are addressed as SPO: - SP9; through the Set Utility 
program and high level languages. They are treated similarly to KBO: 
and KBl: on the Single Board Computer (SBC), and KB2: on the 
IEEE/RS-232 Option (-008). 

Up to three DSI modules can be installed in the 1722A. Each port may 
be configured for these electrical interfaces: 

n RS-232-C 



□ 20 mA Current Loop 

Each port buffers incoming and outgoing data and signals the external 
device when the buffers are nearly full to prevent loss of data. The 
signaling method or protocol may be selected as discussed below. The 
ports are controlled by a microprocessor which reduces the overhead 
on the Single Board Computer (SBC). System throughput is a function 
of the data being transferred at the floppy disk and the IEEE-488 and 
KBx: ports. If the load from these devices i’s heavy, external devices will 
be held off more frequently regardless of the data rate selected. 
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The Operating System (FDOS) which is supplied on the 1 722A System 
Disk includes a device driver for the -009 option. This operating system 
must be used in order for your software to be able to access the Dual 
Serial Interface. If necessary, you can reconfigure the operating system 
by using this disk and following the instructions in Section 3 of the 
I722A System Guide. 

The disk also includes the Serial Port Software Driver (SPIO. OBJ). 
This driver allows a BASIC program to directly monitor and control 
the various lines of the serial interface, including RS-422 ENABLE, 
which some users may require. Information later in this section 
describes the operation of the driver. 



Inspect the shipping carton for damage. Notify the shipper 
immediately if the carton appears to have been damaged in shipping. 
Unwrap the module and inspect it for damage. 



INSTALI 



The Option has 



been configured at the factory as 



follows: 



Electrical Interface RS-232-C 



Data Bits 
Parity 
Stop Bits 
Flow Control 
Board Address 



7 



none 




The jumpers and switches are set at the factory as shown in the figure 
on the next page. Jumpers JPRJ , 2, 3, 4, 5, 6, 29, and 35 are not user- 
configurable and must remain in the positions shown. Check all 
jumpers and switches to be sure they match the factory configuration. 

Use the directions in the Options Section of the System Guide 
“Installing Hardware Options” to install the -009 option into the 
1722A. 

If you have reconfigured the Operating System with the SYSGEN 
Program, make sure that the Dual Serial Interface Driver has been 
included. You can check this by re-booting the controller with your 
version of the Operating System and then running the CONFIG 
Program supplied on the standard System Disk. 



9-38 




The signals for all three interface types are available on each of the port 
connectors. Since this is a modification of the RS-232-C standard, the 
redefined pins can be switched off using SW104 and SW204 when RS- 
232-C is desired. This allows using cables with connections for signals 
defined by the standard to be used. Refer to the section “Electrical 
Interfaces” for connections to external devices. 

In case of problems with the new module, recheck your work to ensure 
that the board is fully seated in the card cage, and that the port 
connectors, jumper positions, and switch settings are correct. If the 
failure continues, refer to Appendix G for troubleshooting 
information, or call your local Fluke Service Center. The Dual Serial 
Interface is included in Fluke’s Module Exchange Program. 

3RY COMFIGURATION 



SW3 

Flow Control 
1 2345678 




Note: * indicates jumpersthatarenotuser-configurable, 
Do not move these jumpers. 
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POWER ON CONFIGURATION 

When the Dual Serial Interface is powered on, these things take place; 

□ The configuration switches are read. 

□ The RS-422 drivers are enabled. 

□ The DSI waits for input or output. 

The initial states of the control lines are shown later. See “Electrical 
Interfaces - RS-232-C”. 



PROTOCOLS 

XON/XOFF 

The ASCII Standard defines two codes that may be used to control 
data transfer between devices. If the input buffer of the device receiving 
data is full or nearly full, XOFF is sent to the transmitting device to 
request the transmission be stopped. When the receiver can accept 
more data, the XON code is sent to resume the transmission. The Set 
Utility program can be used to enable or disable this protocol, and 
refers to the protocol as “stall input” and “stall output”. 




SRTS is a handshake line that is used for flow control with external 
devices that cannot respond to XON/XOFF codes. The polarity of 
SRTS is set by the Flow Control configuration switch (SW3). 



CONFIGURATION 

The electrical interfaces and power-up configuration can be changed 
using the switches and jumpers described in the following tables. After 
the tables, the next sections discuss each interface and typical setups. 
The Set Utility program can also be used to change port 
characteristics. See Section 5 of the System Guide for details. 

NOTE 

The Port Characteristics and Flow Control switches are read 
only at power-up. 
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Board/Port Addresses (SW1) 



BOARD PORT 12 34 



1 


1, 


0 


0 


0 


0 


0 


2 


3. 


2 


0 


0 


0 


1 


3 


5, 


4 


0 


0 


1 


0 


4 


7, 


6 


0 


0 


1 


1 


5 


9, 


8 


0 


1 


0 


0 



J1 = EVEN Port 
J2 = ODD Port 



ON = 1 = dosed = enabled 
OFF = 0 = open = disabled 



Port Characteristics (SW101 AND SW201) 



12 3 4 




5 6 7 8 




1111 


19200 Baud 


1 


Data Bits: 7 


1110 


19200 


0 


8 


110 1 


9600 






1100 


7200 


1 1 


Parity: even 


10 11 


4800 


1 0 


odd 


10 10 


3600 


0 1 


none 


10 0 1 


2400 


0 0 


none 


1 000 


2000 






0 111 


1800 


1 


Stop Bits: 2 


0 110 


1200 


0 


1 


0 10 1 


600 






01 00 


300 






0 0 11 


150 






00 10 


134 






00 0 1 


110 






0000 


75 
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Dual Serial interface 



Flow Control (SW3) 

1 2345678 

1 

0 

1 

0 

X X 



Odd Port 
enable 
disable 
active high 
active low 
not used 



1 

0 

1 

0 

X X 



Even Port 
enable 
disable 
active high 
active low 
not used 



Port Connector Signal Disable Switches (SW104 and SW204) 



1 RS-422 Rx+ 

2 Rx- 

3 20mA Rx+ 

4 Rx- 

5 I1-/-12V 

6 I2-/-12V 

7 RS-422 Tx-f 

8 Tx- 

9 20mA Tx-f 

10 Tx- 



Clear To Send (CTS) Input to UART (JPRl 16 and JPR216) 

Left CTS 

Right CTS and SRLSD 




>-X<' 



UART Receive input (JPRl 17 and JPR2i7) 

Left 20mA loop 

Middle RS-422 
Right RS-232-C 



Voltage/Current Sources (JPR102, 103, 202, 203) 

Left 20mA 

Middle OFF 
Right +I2v 








50ft 



19200 Baud 



Data Communications Equipment (DCE) 
(Use RS-232-C Cable) 



Data Terminal Equipment (DTE) 
(Use “Null Modem Cable”) 
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I780A 

VTIOO 

Printers 
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Port Connections 

To DCE From DCE 

Pin Circuit Function Pin Circuit Function 



1 


AA 


Shield 








7 


AB 


Signal Common 








2 


BB 


Transmitted Data 


3 


BA 


Received Data 


4 


CA 


Request to Send 


5 


CB 


Clear to Send 


20 


CD 


Data Terminal Ready 


6 


CC 


Data Set Ready 


19 


SCA 


Secondary Request to Send 








11 


UND 


RS-232-B 


22 


CE 


Ring Indicator 








12 


SCF 


Secondary Received Line Signal 
Detector 








8 


CF 


Received Line Signal Detector 



The Clear To Send jumpers (JPRl 16 and 216) allow the CTS input to 
the UART to be either the CB circuit or the logical AND of CB and 
SCF. This feature is useful for external devices that use the SCF circuit 
as a “busy” indicator. 



Power-on States of the Control Lines 


SIGNAL 


PIN 


STATE 


8B 


2 


MARK 1 


CA 


4 1 


ON 


SCA ! 


11, 19 


OFF 


CD 


20 


ON 1 
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NOTE 



Dual Serial Interface 



Clear To Send (Pin 5) controls the transmission from the port. 
When it is ON, the corresponding DART is permitted to 
transmit. When it is OFF, the UART stops transmitting, 
beginning at the next character boundary. This behavior is a 
function of the UA R T hardware, and always applies. It cannot 
be disabled. Leave Pin 5 unterminated if not used by the 
receiving device. 



CONFIGURATION 




Notes: * indicates jumpers that are not user-configurable. Do not 

move these jumpers. 



t indicates switches or jumpers that can be set as desired. 
Refer to tables in the text for settings. 





Maximums 



Distance 4000 feet 

Data Rate 19200 Baud 

Typical Applications 



The circuitry incorporates protection networks on the drivers and 
receivers to reduce susceptibility to high voltage transients and faults. 

Port Connections 



To External Device From External Device 



PIN 


SWITCH 


SIGNAL 


PIN 


SWITCH 


SIGNAL 


9 


7 


Tx+ 


14 


1 


Rx+ 


10 


8 


Tx- 


15 


2 


Rx- 


7 




Signal 

Ground 
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CONFIGURATION 




Mules: * indicates jumpers ihai are noi user-configurable. Do not 

move these jumpers. 

indicates swiiche.s or jumpers that ran beset as desired. 
Refer to tables in the text for settings. 
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20 MA LOOP 

Maximums 

Distance 1000 feet 
Data Rate 4800 Baud 
Voltage 30 Vdc 



Typical Application 


















Port Connections 








To Externa! Device 


From External Device 


PIN 


SWITCH 


SIGNAL 


PIN 


SWITCH 


SIGNAL 


12 


9 


Tx+ 


24 


3 


Rx+ 


23 


10 


Tx- 


25 


4 


Rx- 


18 


5 


I1-/-12V 


17 


JPRX02 


i1+/-L12v 


16 


6 


I2-/-12V 


13 


JPRxOS 


I2+/+12V 
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20 MA CURRENT LOOP CONFIGURATION 




Notes: * indicates jumpers that are not user-configurah/e. Do not 

move these jumpers. 

t indicates switches or jumpers that can be set as desired. 
Refer to tables in the text for .sellings. 
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The T)09 device driver in FDOS allows the programmer to use theDSI 
from all languages and utility programs just as any other serial device. 
The ports are specified as SPO: through SP9: depending on the board 
address selected. 

Two additional routines are provided to gain more direct control of the 
interface lines. The user can read the current state of ail the input and 
output lines and can set the output lines to any state he desires. The 
user can also enable and disable the RS-422 drivers. These routines are 
supplied in the following files for each programming language: 

LANGUAGE FILENAME SUPPLIED WITH 




LINK “SPiO” (RETURN) 



To use the routines in Compiled BASIC, use the FIND command in 
the Linking Loader, as follows: 



escriptlon 

The module consists of two routines: SPGETS and SPSETS, 
SPGETS is called to get a “snapshot” of the inputs and outputs. A port 
number between 0 and 9 is specified, along with an integer word into 
which the status is to be stored by SPGETS. When it is called, 
SPGETS retrieves the current input and output status and returns the 
value to the caller in the specified integer variable. The state of each line 
is represented by a corresponding bit in the status word. The bit 
assignments are illustrated below. 
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SPSETS sets the state of the output lines. A port number between 0 
and 9 is specified, along with an integer word which contains the 
control data to be output to the control lines. The bit assignments in 
the control word are identical to the assignments in the status word. 
The input portion of the status/ control word is ignored by this 
function. 




CALL BPGETSCpoT'tX. status*/.) 
INTEGER port'/. 



ststusX 



0 for BPO: 

1 for SPi: 



9 for 5F9: 



RS-232 

bit 

value 



1 

2 

4 

8 

S28 



2S6 

512 

1024 

2043 

4096 



input/output line status 



pin 




des 


cription 


20 


Data 


Terminal Readu 


19 


Secondar 


^ Request To Send 


1 1 


Unde 


fine 


4 


Requ 


est 


To Send 


— 


RB-422 Output Enable 


12 


Sec 


Rev 


Line Big Detector 


22 


Ring 


Ind 


i cator 


8 


Rev 


Line 


Signal Detector 


6 


Data 


Set 


Ready 


5 


C 1 ea 


r To 


Send 



CALL SPSETS(porty.. statusX) 
INTEGER port-/. 



statusX 



0 for SPO: 

1 for SPI: 

9 ' for' SP9: 

RS-232 output line control 
bit 



value 


pin 


description 


1 


20 


Data Terminal Ready 


2 


19 


Secondary Request to Send 


4 


1 1 


Undefinee ; 


8 


4 


Request To Send ; 


128 


- 


RS-422 Output Enable 
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Errors 

All errors are recoverable: 

5 1 00 FDOS function call failed (usually means option missing or 
faulty) 

5101 inv'tlid port number 



The RS-232 output lines may be changed. Turning off Request To 
Send inhibits transmission on the corresponding port. 

TRAN RROGRAIVfMfNG 

From FORTRAN, the routines are called in the same manner as they 
are in BASIC, except that an error parameter is passed as follows: 

CALL SPGETS (port, status, error) 

CALL SPSETS (port, status, error) 

If the error value returned is non-zero, then one of the following has 
occurred: 

No device driver in FDOS 
Option missing or faulty 
illegal port number specified 
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MBLY LANGUAGE PROGRAMMmG 

The FDOS driver for the option supports all the applicable functions, 
which are listed below. For a description of the call conventions, refer 
to the FDOS direct I/O functions for KBx: ports in the Assembly 
Language Manual. The functions are; 

0 Read a Record 

2 Write a Record 

4 (unused) 

6 Initialize Driver 

8 Get Port Configuration 

10 Set Port Configuration 

12 Return Number of characters/ lines in Input Buffer 
14 Get a Character 

16 Put a Character 

18 Send a Break 

20 (unused) 

22 (unused) 

24 Return Number of Characters in Output Buffer 

Full control of the U ARTs on the Dual Serial Interface option requires 
one additional FDOS call, described below. 



26 READ/WRITE RS-232 LINES 
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This function either sets or gets the the current state of the RS-232 
signal lines. When the Set/Get flag is non-zero, the lower byte of the 
RS-232 data word is loaded into the latches that drive the RS-232 lines. 
When the set/get flag is zero, the entire RS-232 data word is returned 
with the current state of the RS-232 interface, including both input and 
output lines. 

In addition, this word also controls the RS-422 data driver. When the 
422EN bills set to one (I), the RS-422 driver is active. When 422EN is 
set to zero (0), the RS-422 output drivers are tri-stated. 

The set function has no effect on the input signal lines. They are always 
sampled directly during a get function. 





This equipment generates and uses radio frequency energy 
and if not installed and used In accordance with the Instruction 
manuals ^ay cause interference to radio and television 
reception. It has been tested and found to comply with the 
limits for a Class B computing device pursuant to Subpart J of 
Part 15 of FCC Rules, which are designed to provide 
reasonable protection against such interference in a 
residential instatlation. If this equipment does cause 
Interference, which can be determined by turning the the 
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INTRODUCTSON 

The Fluke I760A and 176! A Disk Drive Systems provide additional 
floppy disk mass storage for the 1722A Instrument Controller. They 
connect to the Controller’s IEEE-488 connector, and are recognized 
and addressed as additional logical devices MFl; - MF4:. 

In addition to the internally mounted floppy disk drive (MFO:), up to 
four other drives can be connected to the Controller. The Fluke mode) 

1760A is a single 5-1/4’ unit, and the 1761 A has two drives. When they 
are installed, they act similar to the internal drive; operation over the 
lEEE-488 bus is transparent to the user. 
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PRE-IHSTALLATION CHECKOUT 

The Disk Drive System is carefully inspected at the factory before 
shipment. Remove it from the shipping carton and inspect it for any 
signs of physical damage that might have occurred during shipment. If 
you find anything wrong, notify the nearest Fluke Service Center 
immediately and file a claim with the carrier. 

IHSTALLATSON 

These procedures describe how to install the Disk Drive System. There 
are two main steps: 

□ Setting the proper line voltage. 

□ Setting the IEEE-488 address. 



! 
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The Disk Drive System is shipped configured to the line voltage 
specified on the order form. If no voltage is specified, the factory ships 
the drive to operate on 120V ac, 47 to 63 Hz. If that is the voltage you 
will be using, skip this procedure, and go on to the next step, setting the 
IEEE-488 address. This procedure is only required if the voltage 
setting is different than that required, but it just takes a moment to 
check, so we recommend that you check the voltage as part of the 
incoming inspection. 



1. Place the drive on a suitable work surface with the rear facing 
you, and with the line cord disconnected. 



2. Slide the clear plastic cover (A) to the side, so that it covers the 
line plug connector. 

3. Look at the wafer (B) at the top of the AC line connector. It 
shows the voltage for which the drive is configured. If the 
number shown differs from the voltage at the installation site, 
remove the wafer from its slot, and re-install it so that the 
correct number shows. This may be either 100, 120, 200, or 240. 

4. Slide the cover back over the wafer, and double check that the 
correct voltage is still visible. 



NOTE 

Changing the wafer’s position changes the voltage 
configuration. No frequency conversion is needed. 

5. Check the fuse (C) against this table, and replace it for the 
correct value if needed. 



Voltage Setting 


Fuse Rating 


100 to 120 
200 to 240 


1 ampere, 250 volt, slow blow 
1/2 ampere, 250 volt, slow blow 



6. Check the power cord supplied with the Disk Drive System to 
ensure that it matches the receptacle. If it does not match, 
contact your sales representative to obtain the correct cord. 
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WARNING 

If it Is necessary to replace the power cord, the replacement 

must have the same polarity as the original, if it does not, a 
shock hazard exists, and the Disk Drive System may be 
damaged. 

7. Plug the AC line plug into the connector (D) at the rear of the 
Disk Drive System. Do not apply power until the complete 
installation procedures have been done. 
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electing the IEEE-488 Address 

After the power requirements have been taken care of, the next step is 
to connect the Disk Drive System to the Controller’s IEEE-488 port. 

1. Disconnect power from the Controller and the Disk Drive 
System. 

2. Remove the Single Board Computer module from the 
Controller (slot 7). Check configuration switch SI to be sure 
that position 5 and 6 are set to the OFF position. Doing so 
makes the Controller the System Controller rather than an idle 
controller. Only a System Controller can manipulate the bus 
control lines to initialize the disk drive. 

3. Replace the Single Board Computer Module into slot 7, and 
reattach the Controller’s rear cover. 

4. Locate the switch labeled “Device Address” on the back of the 
Disk Drive System. Set it to IEEE-488 Address 20, Parallel 
Poll Address 4. 



PARALLEL 



POLL I 






ADDRESS 






1 


. 2 , 


3 


4 


5 


1 






1 






0 


0 




0 



IEEE-488 

ADDRESS 



6 


7 


1 






0 




NOTE 

If the Controller is installed in a system, make sure that no 
other connected equipment is set to Address 20, because bus 
contention problems might occur, in which case neither the 
drive nor the other device will operate properly. Also make 
sure that the Controller itself is not set to address 20. 

If a second Disk Drive System is connected to the Controller, it 
must be set to Device Address 21, Parallel Poll Address 5. 
(Switches ON: I, 3. 4, 6, and 8.) 
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5. Attach the Disk Drive System IEEE-488 connector to the 
IEEE-488 connector on the Controller's Single Board 
Computer module. If you need to order the cable, see the table 
below: 



Fluke P/N 


Length 


Y8021 


1 meter 


Y8022 


2 meters 


Y8023 


4 meters 




1760A and 1761A Disk Drive Systems 



At this point, all the steps have been completed to prepare for using the 
new Disk Drive System. To begin using it, remember that it provides 
new logical devices: MFl:, and so on. Also be sure to format floppy 
disks prior to use, as they are not formatted at the factory prior to 
shipment. 



WARNING 




Doing so may damage the directory or data files on the disk. 



indicator is lit 



1. Connect the Disk Drive System to the Controller’s IEEE-488 
Port 0 connector, and power up both units. 



2. Follow the instructions in Appendix G of the System Guide to 
run the diagnostic MFXTST. This test will check the disk drive 
speed and media detection logic, then seek, format, write, and 
read data back from a disk installed in each drive, 



There is a software device driver for the 1760 A and 1761 A that can be 
linked into the 1722A operating system (FDOS). The device driver 
allows the system software and applications programs to treat the Disk 
Drive System as another logical device in the system. The device names 
are MFl: and MF2: for a Disk Drive System at IEEE-488 Address 20, 
and MF3; and MF4: for a Disk Drive System at Address 21. 



The operating system (FDOS2.SYS) supplied on the 1722A System 
Disk does not contain the device driver for the 1760A and 1761 A. You 
must run the SYSGEN program to create a new operating system 
which includes this driver before you can use the Disk Drive System. 
Follow the instructions in Section 3 of the 1722A System Guide to 
reconfigure the operating system. 




of Part 15 of FCC Rules, which are designed to provide 
reasonable protection against such interference when 
operated In a commercial environment. Operation of this 
equipment In a residential area is likely to cause interference in 
which case the user at his own expense will be required to take 
whatever measures may be necessary to correct the 
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SNTRODUCTION 

The Fluke I765A/AB Winchester Disk Storage System provides 10 
megabytes of mass storage for the 1722A Instrument Controller. It 
connects to the Controller’s IEEE~488 connector, and is recognized 
and addressed as four logical devices: WDO:, WDI:, WD2:, and WD3:. 
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PRE-iNSTAUATiON CHECKOUT 

The disk drive is carefully inspected at the factory before shipment. 
Remove it from the shipping carton and carefully inspect it for any 
signs of physical damage that might have occurred during shipment. If 
you find any damage, notify the nearest Fluke Service Center 
immediately and file a claim with the carrier. 

These procedures describe how to install the disk drive. There are two 
main steps: 

□ Setting the proper line voltage. 

□ Setting the IEEE-488 address. 
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The 1765A/AB is shipped configured to the line voltage specified on 
the order form. If no voltage is specified, the factory ships the drive to 
operate on I20V ac, 47 to 63 Hz. If that is the voltage you will be using, 
skip this procedure, and go on to the riext step, setting the IEEE-488 
address. This procedure is only required if the voltage setting is 
different than that required, but it just takes a moment to check, so we 
recommend that you check the voltage as part of the incoming 
inspection. 



1 . 



you, and with the line cord disconnected. 



2. Look at the wafer (A) at the top of the AC line connector. It 
shows the voltage for which the drive is configured. If the 
number shown differs from the voltage at the installation site, 
remove the wafer from its slot, and re-install it so that the 
correct number shows. This may be either 100, 1 20, 200, or 240. 



NOTE 

Changing the wafer’s position changes the voltage 
configuration. No frequency conversion is needed. 



3. Check the fuse (B) against this table, and replace it for the 
correct value if needed. 



Voltage Setting I 


Fuse Rating 


100 to 120 
200 to 240 


2 ampere, 250 volt, slow blow 
1 ampere, 250 volt, slow blow 



4. Check the power cord supplied with the disk drive to ensure 
that it matches the receptacle, If it does not match, contact 
your sales representative to obtain the correct cord. 



WARNING 

If it is necessary to replace the power cord, the replacement 
must have the same polarity as the original. If it does not, a 
shock hazard exists, and the disk drive may be damaged. 



Plug the AC line plug into the connector (C) at the rear of the 
disk drive. Do not apply power until the complete installation 
procedures have been done. 
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Selecting the IEEE-488 Address 

After the power requirements have been taken care of, the next step is 
to connect the 1765A/AB to the Controller’s IEEE-488 port. 

1. Disconnect power from the Controller and the disk drive. 

2. Remove the Single Board Computer module from the 
Controller (slot 7). Check configuration switch S 1 to be sure 
that positions 5 and 6 are set to the OFF position. Doing so 
makes the Controller the System Controller rather than a 
Controller in Charge. Only a System Controller can 
manipulate the bus control lines to initialize the disk drive. 

3. Replace the Single Board Computer Module into slot 7, and 
reattach the Controller’s rear cover. 

4. Locate the switch labeled “Device Address” on the back of the 
1765A/ AB. Set it to IEEE-488 Address 12. The orientation of 
the switch differs between revisions of the Disk Drive System, 
but the back panel makes clear the required direction to place a 
switch ON switch settings. When a switch is set to i, it is ON 
(closed). For Address 12, switches 5 and 6 should be ON, and 
all others OFF as shown: 



1 2 3 4 5 6 7 8 











1 


1 






1 


0 


o 


0 


0 






0 


0 


0 



NOTE 

If the Controller is installed in a system, make sure that no 
other connected equipment is set to Address 12, because bus 
contention problems may occur, in which case neither the drive 
nor the other device will operate properly. Also make sure that 
the Controller itself is not set to address 12. 

5. Attach the disk drive IEEE-488 connector to the IEEE-488 
connector on the Controller’s Single Board Computer module. 
If you need to order a cable, see the table below: 



Fluke P/N 


Lensth 


Y8021 


1 meter 


Y8022 


2 meters 


Y8023 


4 meters 
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Testing the Hard Disk Drive 

At this point, all the steps have been completed to prepare for using the 
new hard disk. To begin using it, remember that it provides four new 
logical devices: WDO: - WD3:. There is no need to format the disk prior 
to use, as it has been formatted at the factory prior to shipment. 




1. Connect the drive to the Controller’s IEEE-488 Port 0 
connector, and power up both units. 

2. Follow the instructions in Appendix G of the System Guide to 
run the diagnostic WDXTST. This test program performs two 
functions: 

Self Test This program sends a self-test command to the 
disk controller inside the 1765A/AB. When it 
receives this command, the 1765A/AB performs 
an internal disk controller test and 
communications test. 

Verify This program checks each sector on the disk for 
errors, and reports any errors to the display. 

3. When the program has been selected, four options will be 
presented on the screen: 

Option 1 - Seif Test 

Option 2 - Verify 

Option 3 - Self Test and Verify 

Option 4 - Exit (Exits to FDOS.) 
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4. Select the option desired. For new installations, Option 3 is 
probably the most useful. If the message “correctable ECC 
error” is displayed during the Verify operation, press 
< RETURN) to continue the test. This indicates that a software 
correctable error occured. Any other errors indicate a faulty 
unit, and should be reported to the local Fluke Service Center. 




There is a software device driver for the 1765A/ AB that can be linked 
into the 1722A operating system (FDOS). The device driver allows the 
system software and applications programs to treat the Winchester 
Disk Drive as four additional logical devices in the system. The device 
names are WDl:, WD2:, WD3: and WD4:. 

The operating system (FDOS2.SYS) supplied on the 1722A System 
Disk does not contain the device driver for the 1765A/ AB. You must 
run the SYSGEN program to create a new operating system which 
includes this driver before you can use the Winchester Disk Drive. 
Follow the instructions in Section 3 of the 1722A System Guide to 
reconfigure the operating system. 
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CRT DISPLAY 
Scanning Method 

Refresh Rate 




Character Capacity 

Standard Character Set 




Non-interlaced raster scan. 

50 or 60 Hz, selectable. 

1280 bytes of dedicated display memory. 16 
lines of 80 characters. 

HIgh-contrast green phosphor, low profile, 
rectangular. 8.6 cm x 20.3 cm (3.4 in x 8.0 

in). 

16 X 80 cells, or 8 X 40 cells. 

96 Standard ASCII characters, graphics 
characters, match, and other useful 
symbols. 

7x9 dots in an 8 X 14 dot matrix. 

Reverse video, blinking, underlining, and 
highlighting. 

Blinking, underline, block, or suppressed. 
7.6 cm X 19 cm (3.0 in x 7.5 in). 

640 x 224 pixels 

64K bytes (2048 x 256 pixels). Independent 
of main memory, 

Character with respect to touch-sensitive 
grid at 25°C after 30 minute warmup; 

±1.5 character horizontal 
±0.5 character vertical 

Change in character positions over the 
operating temperature range: 

1 character horizontal 
0.5 character vertical 



DISK DRIVE 

Disk Size 

R/W Heads 

Tracks 

Track Density 

Rotational Speed 

Disk Error Rates 

RECOVERABLE 

NON-RECOVERABLE 



Industry standard SVi-inch 
2 per disk drive 
80 (40 per side) 

48 tracks per inch 

300 RPM 

1 per 10® bits read 
1 per 10’2 bits read 




Specifications 



Recording Format 

BYTES PER SECTOR 512 

SECTORS PER TRACK 10 

ENCODING METHOD MFM (double density) 

Total Formatted Storage 409,600 bytes per disk 

ENVIRONMENTAL 

Operating 

WITH DISK MEDIA 10'’C to 40“C (50°F to 104°F) 

20% to 80% RH (non-condensing) 

WITHOUT DISK MEDIA 10°C to 40'’C (50“F to 104°F) 

5% to 90% RH (non-condensing) 

Storage 

WITH DISK MEDIA 10°C to 52°C (50^F to 126° F) 

8% to 80% humidity (non-condensing) 

WITHOUT DISK MEDIA -40° C to 60°C (-40° F to 140°F 

5% to 90% humidity (non-condensing) 

EMI and RFI Emissions Complies with FCC Part 15, Subpart J, 

Class B; VDE 0871, Class B; CISPR 11-1975 

GENERAL 

Dimensions 13 cm H x 43 cm W x 55 cm L (plus feet) 

(5,25 in H X 17.0 in W x 21.5 in L), See 
Outline Dimensions. 

Weight 

CONTROLLER 15.5 kg (34 lbs). 

KEYBOARD 1.4 kg (3 lbs). 

Power 175W max. 

VOLTAGE 90-132 ac, 47-63 Hz (use 3A AGO fuse) 

180-264 ac, 47-63 Hz (use 2A AGO fuse) 
POWER DISSIPATION 175W max. 




< 3 - 



^THESE HOLES USED FOR MOUNTiNG OF FEET. CAN BE USED FOR 
NON STRUCTUAL INSTRUMENT MOUNTING. 



2' ALLOW 4"MINtMUM AT REAR AND CRT SIDE OF INSTRUMENT FOR 
AIRFLOW. 



8.00 (REF) 




17.(X)0 MAX 




BACK 






GND 


Chassis Ground 


XMT 


Transmitted Data 


REG 


Received Data 


RTS 


Request to Send 


GTS 


Clear to Send 


DSR 


Data Set Ready 


RET 


Signal (Logic) Ground 


GD 


Carrier Detect 


UNO 


Undefined 


SRLSD 


Secondary Receive Line 
Signal Detect 


DTR 


Data Terminal Ready 


SRTS 


Secondary Request to Send 



ndicates signal direction 



O Indicates unused pins 
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IEEE-488-1978 instrument Ports (Port 0 and Port 1) 





MANAGEMENT 

BUS 



Data input and output lines, 
bidirectional and active-low, 
DI08 is most significant. Data 
transfers are 8-bit parallel and 
serial. 



Attention. Acliviated by the 
1722 A when peripheral devices are 
being assigned as listeners and 
talkers. The 1722A assumes it is 
the only source of this signal. 



Service request. Any peripheral 
device on the Instrument Bus can 
request the attention of the 1722A 
Controller by setting SRQ active 
low. 



Interface clear. Set by the 1722A 
to place all instruments on the 
bus in a predetermined reset 
state. The 1722A assumes that it 
is the only source of this signal. 



Remote enable. Causes all 
responding instruments on the Bus 
to ignore their front panel 
controls and operate under remote 
control via signals and control 
messages received over the Bus. 
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IEEE-488-197S Instrument Ports (Port 0 and Port 1) (cont) 



BUS 


PIN 


SIGNAL 


DEFINITION 


MANAGEMENT 
BUS (cont) 


5 


EOl 


End or identify. Can be used by 
a talker to identify the end of a 
data transfer sequence, or with 
ATN by a Controller, to execute a 
polling sequence. 




7 


NRFD 


Not ready for data. An active low 




19 


NRFD Return 


signal line to indicate that one 
or more assinged listeners are not 
ready to receive the next data 
byte. When all of the assigned 
listeners for a particular data 
transfer have released NRFD. the 
NRFD tine goes inactive high. The 
talker can then place the next 
data byte on the Data Bus. 




6 


DAV 


Data valid. Activated by the 


TRANSFER 

BUS 
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DAV Return 


talker shortly after the placing a 
valid data byte on the Data Bus. 

An active low DAV signal tells 
each listener to capture the data 
byte presently on the Data Bus. 
The talker should be inhibited 
from activating DAV when NRFD is 
active low. 




8 


NDAC 


Not data accepted- Held active 
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NDAC Return 


low by each listener until the 
listener captures the data byte 
currently being transmitted over 
the Data Bus. When all listeners 
have captured the data byte, NDAC 
goes inactive high. This tells 
the talker the transfer is 
complete, 
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ASCII and IEEE-488 Mnemonic Abbreviations 



ACK 


Acknowledge 


MSA 


My Secondary Address 


ASCII 


American Standard Code for 


MTA 


My Talk Address 




Information Interchange 


NAK 


Negative Acknowledge 


ATN 


Attention 


NDAC 


Not Data Accepted 


BEL 


Beil 


NRFD 


Not Ready For Data 


BS 


Backspace 


NUL 


Null 


CAN 


Cancel 


OSA 


Other Secondary Address 


CR 


Carriage Return 


OTA 


Other Talk Address 


DCL 


Device Clear 


PCG 


Primary Command Group 


DCn 


Device Control 1, 2, 3, or 4 


PPC 


Parallel Poll Configure 


DEL 


Delete 


PPD 


Parallel Poll Disable 


DIOn 


Data Input/Output 1 through 8 


PPE 


Parallel Poll Enable 


DLE 


Data Link Escape 


PPRn 


Parallel Poll Response 1 through 8 


ENQ 


Enquiry 


PPU 


Parallel Poll Unconfigure 


EOF 


End of File 


REN 


Remote Enable 


EOi 


End or Indentify 


RS 


Record Separator 


EOT 


End of Transmission 


SDC 


Selected Device Clear 


ESC 


Escape 


SI 


Shift in 


ETB 


End of Transmission Block 


SO 


Shift Out 


ETX 


End of Text 


SOH 


Start of Heading 


FF 


Form Feed 


SP 


Space 


GET 


Group Execute Trigger 


SPD 


Serial Poll Disable 


GND 


Ground 


SPE 


Serial Poll Enable 


GTL 


Go To Local 


SRQ 


Service Request 


HT 


Horizontal Tab 


STB 


Status Byte 


IEEE 


Institute of Electrical and 


STX 


Start of Text 




Electronic Engineers 


TCT 


Take Control 


IFC 


Interface Clear 


UNL 


Unlisten 


LF 


Line Feed 


UNT 


Untalk 


LLO 


Local Lockout 


US 


Unit Separator 


MLA 


My Listen Address 
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Front panel push switch that causes the Controller to tenninate the 
current program and return to the shell without clearing memory or 
performing the power-up self-test. When pressed simultaneously with 
RESTART, causes the system to perform a cold start. 



A coded number representing the location of an item. Examples 
include bus address and program address. 



88 command 

A bus command from a controller commanding an instrument at a 
designated address to talk or listen. 



have been addressed as talker or listener. 



A user written program designed to perform specified functions in a 
working environment. 



A collection of data items, organized as a row x column matrix. 



element identifier 

The subscript of an array variable that identifies the row and column of 
the desired array element. In the expression: A$(3,5), (3,5) is the array 
element identifier, referring to row 3, column 5. 



Acronymn for American Standard Code for Information Interchange. 
ASCII is a standardized code set of 128 characters, including full 
alphabetic (upper and lowercase), numerics, and a set of control 
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asynchronous data 

Information transmitted at random times, normally one character at a 
time, and at predefined, self-clocking baud rates. See synchronous 
data. 



Beginner’s All-purpose Symbolic Instruction Code, a general purpose, 
high-level language that has been widely accepted because of its 
versatility and the ease with which it can be learned. Fluke BASIC has 
added commands for instrument control. 



The serial transfer rate in bits per second including all framing bits used 
to identify the start and end of characters or messages. 



binary 

A number system based on zero (0) and one (1) representations. It is 
often used to represent data or instruction codes. There are only two 
numbers, so digital computers can use binary for their operations 
because each number can be represented as the state (on or off) of a 
transistor. 



A contraction of binary digit. A bit is either a one or a zero and 
respresents the smallest single unit of computer information. Bits are 
often used in groups of eight to represent ASCII characters. 



block 

Memory size equal to 512 bytes. 



bootstrap 

A short program permanently recorded in ROM whose only function 
is to read an operating system program from bulk storage into system 
memory and transfer control to it. 

buffer 



A temporary storage area in main memory used to store data. 




A device attached to a computer that can store much more program or 
data information than the computer’s main memory can hold. The 
Instrument Controller incorporates two types of bulk storage;' floppy 
disk and hard disk. Also called mass storage. 



bus 

The IEEE-488-1978 standardized interconnection system used for 
connecting instruments. Also, bus can refer to any set of parallel 
connections that have the same meaning for each unit connected to 
them. 

Bus address 

A 7-bit code placed on the IEEE-488 bus in command mode to 
designate an instrument as a talker or listener. 



A grouping of eight bits of information into a coded representation of 
all or part of a number or instruction. Often a 7-bit ASCII character is 
referred to as a byte, with the eighth bit available for parity if needed. 
Bytes are commonly considered as 8-bit storage areas to represent 
ASCII characters. 



chaining 

A method of operating a program that is larger than available main 
memory. The technique is to break the program into smaller elements, 
and call in the next element from bulk storage as each succeeding 
element is completed. Requires highly modular programming to be 
effective. See structured programming. 



Channel 

A communication path opened between an application program and a 
file or a system device. 



The portion of the display memory that is used for displaying the 
normal- and double-sized characters. The character set includes the 
upper- and lower- case alphabet, the ten numerals, and punctuation. 
See graphics plane. 




A grouping of ASCII characters. 



cold start 

The power-up activities of the Controller. These include clearing all 
memory including E-Disk, performing a self-test, and loading the 
operating system. A cold-start occurs when the system is powered up, 
or when RESTART and ABORT are pressed simultaneously. 



Command file 

A file that, when designated active by FDOS, is used as a substitutefor 
keyboard inputs. In Fluke Instrument Controllers, a command file 
with the name STRTUP.CMD is processed each time the Controller is 
initialized by a cold start or power-on. 



mode 
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Fixed values which may be floating-point, integer, or string data types. 



control character 

Used to produce specific actions such as terminating program 
execution, exiting from the Editor, halting and restarting scrolling. 




A device connected to a bus capable of designating instruments as 
talkers or listeners by using bus message sequences. A device does not 
need to be programmable to act as a controller. However, only a 
controller can examine the data or status of instruments to determine 
appropriate conditions for designation changes. There can be only one 
active controller on a bus at one time. 



Central processing unit, the controlling instruction and data processor 
in any computer system. In the Fluke Instrument Controller, the CPU 




Cathode Ray Tube, the display screen on the Instrument Controller 
front panel. 




The pixel location defined by X.Y coordinates in the graphics plane 
that is the starting position for turning the beam on or off to paint a 
line, or to move to another location. On power up, the current location 
is XO, YO. 



cursor 

The visible pointer on the CRT display that allows the user to 
recognize the position being pointed to by the system software. 



A file holding either random or sequential access information. 
Contrasted to a program file. 



Data lines 

Eight of the sixteen bus lines which carry either data or multiline bus 
messages (Universal, Addressed and Address commands). 

Data mode 

The default mode of the bus when the controller has left the ATN 
(attention) line false. All transfers of data or instructions are between 
instruments. 



processing 

The ability to perform calculations on collected data and formatting it 
into readable reports. 



debugging 

Any method of detecting and correcting syntax and structure errors in 
a program. 




software selects when the user does not 



A hardware resource that can act as a source or destination of data. In 
this manual, device is used in two different ways: 1. To represent the 
internal devices recognized by the Operating System. In this usage, the 
Controller’s devices are identified by two letters, a number, and a 
colon. For example, MFO: identifies the mini-floppy drive. 2. The 
symbol followed by a number from 0 to 30 represents external 
devices, such as instruments connected to the IEEE-488 bus. The 
BASIC language statement “PRINT @ 2” followed by program data 
would address instrument 2 as a listener device, and send it program 
data. 



Display control 

An ANSI-standard character sequence of ASCII characters which 
produces a desired display effect such as cursor position or reverse 
image. 



-Disk 

Fluke Trade Mark for the Electronic disk, a memory configuration 
that makes use of memory as if it were a file-structured device. See 
Electronic Disk. 




A system software program that enables a user to generate and update 
an application program. 



Electronic Industries Association, publishers of standard RS-232-C 
for serial data ports. 



Electronic Disk 

A portion of the memory designated as a file-structured device. Part of 
the system’s dynamic RAM memory is configured so that it 
functionally emulates a floppy disk. The electronic disk is about 100 
times faster than the floppy disk and has no moving parts to wear or 
cause noise. 

EPROM 




Escape sequence 

A string of characters including an escape (ESC) character, a numeric 
parameter and a function code which is recognized as a Display 
control. 




A combination of data-names, numeric literals, and named constants, 
joined by one or more arithmetic operators in such a way that the 
expression as a whole can be reduced to a single numeric value. 



A listener instrument that requires a two-byte address. See secondary 
commands. 



Extended Talker 

A talker instrument that requires a two-byte address. See secondary 
commands. 




Floppy Disk Operating System program. FDOS is the executive 
monitor program of the 1 722A Instrument Controller, and is supplied 
as a file on the System Disk with the filename FDOS2.SYS. Usually 
called “the Operating System”, FDOS is the Controller’s central 
program. When any other program is exited, FDOS takes control 
(unless the BASIC statement SET SHELL has been used to change the 
environment). The purpose of FDOS is to load other programs. 



A collection of related information designated by name as a unit. 
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floating-point variable 

A representation of a general-purpose number. They are characterized 
by wide range (up to 308 places from decimal) and high resolution (up 
to 15 places). When displayed without modification, up to seven of the 
digits are displayed, with the last one rounded if necessary. If the 
decimal is out of range of the display, an exponent of ten is included to 
bring it to just left of the first number. For example, .00123456789 is 
displayed as 0.1234567e-02, and 1234567.89 is displayed as 1234568. 
Note that the inexactness of floating-point representation occasionally 
must be considered. For example, IF7*(1.7)=1 will evaluate false. See 
integer. 

floppy disk 

A bulk storage recording device that uses a flexible mylar disk similar 
to recording tape to record programs and data. The location of 
information on the disk is identified by track (distance from center) 
and sector (pie-shaped radial subdivision). 

A pictorial, symbolic representation of a program. Various shapes 
represent commands, computations, or decisions. A flowchart is the 
recommended step between an algorithm specification and program 
writing. It facilitates understanding and debugging because it breaks 
the program down into logical, sequential modules. 



See File Utility Program 




The portion of the display memory where the lines and patterns 
displayed by the graphics routines are stored. The area is measured in 
pixels, rather than bytes. One pixel is the smallest amount of graphics 
information that can be stored or displayed. The graphics plane is 2048 
pixels long and 256 high. The display provides a moveable window 
looking into the graphics plane. The window is 640 by 224 pixels. See 
character plane. 



handshaking 

Refers to the 3-wire hardware protocol used to exchange data on the 
bus. The three bus lines (DAV, NRFD, and NDAC) indicate a remote 
instrument’s readiness to send or receive data. 
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hexadecimal 

A number system based on 16 digits. Sometimes called hex» the system 

uses A, B, C, D, E, and F, to represent the numbers above 9. 



high-level language 

Any programming language that requires conversion through a 
compiler or interpreter into machine code instructions. Examples of 
high-level languages are BASIC and FORTRAN. 



IEEE 

Institute of Electrical and Electronic Engineers, Inc., 345 East 47th 
Street, New York, NY, 10017. The IEEE is the publisher of Standard 
488-1978 used for interconnecting instruments to the Fluke Instrument 
Controller through the bus. 

IEEE-4Sa-1i7S 

A bus standard agreed upon by participating instrument 
manufacturers for the interconnections of instruments into a 
functional system. Also known as the GPIB (General Purpose 
Instrumentation Bus). The standard is published and maintained by 
the IEEE. 

immediate mode 

A method to use BASIC directly as each line is typed in rather than 
storing a sequence of lines as a program for later execution. In 
Immediate Mode, line numbers are not used and each line is executed 
as soon as the RETURN key is pressed. 



In an IEEE-488 system, designates the piece of equipment that asserts 
control over the bus, and which establishes the roles of other connected 
equipment as listeners or talkers. 



integer variable 

A representation of an exact number. They are characterized by 
limited range (-32768 to 32767) and numeric resolution. Integers are 
normally used for event counting, and for comparisions where 
exactness is required. See also floating-point. 
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interface 

A hardware and software connection of a device to a system. For 
example, in the Fluke Instrument Controller, the DMA/Floppy 
Interface is needed for the system to gain access to the floppy disk. 



Interpreter 

A system software program that interprets the statements of a high- 
level language program (such as BASIC), producing and executing 
machine code. 



lexical file 

An intermediate form of an application program that occupies less 
space and eliminates some processing steps for the Fluke BASIC 
Interpreter. Line numbers are represented in binary format and all 
commands and operators are reduced to binary form. Lexical files 
always have “.BAL” extensions. 



Istener 

A bus device designated by a controller to receive data or instructions 
from a designated talker or controller. There can be more than one 
listener on a bus at the same time. 



oad@r 

A program which places another program into main memory for 
execution. 



logical expression 

An expression containing variables, constants, function references, 
etc., separated by logical operators and parentheses. 



logic operator 

A functions that performs comparions, selections, matching, etc. In 
BASIC, the logical operators are AND, OR, NOT, and XOR. These 
are used for either Boolean operation or for bit-manipulation. 



The coded bit-patterns of directly executable machine-dependent 
computer instructions, represented by numbers or binary patterns. 
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A program that operates on a particular model of computer. 

msehine-independent program 

A program that operates on any computer system that has the 
necessary hardware and supporting software. 

main memory 

The RAM memory from which the microcomputer directly executes 
all instructions and which is used for fast, intermediate storage of data 
or programs. 

main memory array 

An array that is stored in main memory. 

management fines 

Five of the sixteen lines on an IEEE-488 bus. The lines are ATN 
(Attention), IFC (Interface Clear), REN (Remote Enable), EOI (End 
Or Identify), and SRQ (Service Request), and call for an immediate 
and specific action, or flag a condition existing on the bus. 

Operating System 

A computer program that manages the resources of computer through 
task scheduling, I/O handling, and file management. See FDOS. 

operator 



Operator’s Keyboard 

The Touch-Sensitive Display. 



parafleS poll 

A method of simultaneously checking the status of up to eight 
instruments on a bus by assigning each instrument a data line to 
transmit a service request. 



A method of error detection that uses one extra bit for each unit of 
information (such as a byte). The parity bit is set to one or zero so that 
the total number of one-bits in the byte is even or odd. 



pathname 

The full designation of a file. The three parts are the device name» file 
name and extension. The first two are separated by a colon, and the last 
two by a period. 



Acronym for picture element; the smallest amount of visual 
information that the display is able to resolve; one dot. 



A connection point used for data transfer. See interface. 




An ASCII character typically used as a bus command. 



Any meaningful sequence of computer instructions that cause a system 
to accomplish a desired task. 



Programmable Read Only Memory, a memory IC that can be 
recorded by an equipment manufacturer using specialized equipment. 



rotection state 

Files prepared on the Controller are assigned a value, either + or - to 
indicate the intent of the author either to prevent or allow alteration. A 
file with the 4- state is protected and will not be written over. A - state 
indicates that the file may be altered if desired. All newly created files 
are assigned the - state. All files supplied on the System disk with the 
Controller are protected. The File Utiltiy Program includes commands 
for changing the protection state of files. 




A set of rules for exchange of information between a system and a 
device or between two systems. 




Random Access Memory. Through common usage, the term has come 
to mean the high-speed volatile semiconductor memory that is 
normally used for system and user memory. 



random access 

A method of obtaining information out of memory; each word of a file 
can be accessed via its own discrete address. See also sequential access. 



raster 

The scanning pattern of an electron beam on a CRT display. A raster 
display uses the same scan pattern all the time, forming images by 
turning the beam on and off at appropriate times. 



RESTART 

Front panel switch that resets the system. When pressed alone, 
RESTART causes a warm start. When pressed at the same time as 
ABORT, causes the system to perform a cold start. 



ROM 



A digital communications standard agreed upon by participating 
manufacturers of data communication equipment for the transfer of 
serial digital data between data communication equipment (DCE) and 
data terminal equipment (DTE). The 1722A is a DTE device. The 
standard is published and maintained by the Electronic Industries 
Association. 



scientific notation 

A system for describing real or integer numbers via a shorthand form 
of floating-point notation. 



econdary command 

IEEE-488 bus commands used to increase the address length of 
extended talkers and listeners to two bytes. 




Information transmitted one bit at a time over a single wire at a 
predefined baud rate. 



sequential aceess 

A method of accessing data in a file by looking at each piece of data, in 
order, until a match is found. See also random access. 



erial poll 

A method of sequentially determining which instrument on a bus has 
requested service. One instrument at a time is checked via the eight 
data lines. 




An external connector that conforms to the industry standard RS-232- 
C. Normally, asynchronous ASCII codes are used unless otherwise 
desired. 



SET Utility Program 

The program that changes the parameters of the I722A’s serial 
communications ports. Supplied on the System Disk with the filename 
SET.FD2, this program permits configuring the Controller so it is able 
to communicate with other devices that implement the RS-232 Serial 
Data Communications standard. Parameters that can be changed 
include baud rate, parity bit, number of bits per character, stall input 
and output characters, and time out value. 



The Controller’s environment, either defaulted to FDOS or changed 
by the BASIC language SET SHELL statement. When RESTART is 
pressed, the Controller returns to the program named by the SET 
SHELL statement, rather than to the bootstrap loader PROM. 



simple variable 

Fluke BASIC program variable that is either an integer or floating- 
point value (not a character string) and contains only one value (not 
dimensional). 



In floppy disks, the beginning of every sector on a disk is determined by 
checking certain data patterns. Hard-sectored disks have 
predetermined sector beginnings designated by a physical marker, 
such as a hole. 



Computer programs and data recorded and used on a medium that can 
be erased and rewritten by program command. 



This term has two meanings: I. The pathname where information 
presently resides when using a File Utility Program command that 
moves a file from one place to another; the input side of the channel 2. 
An instrument connected to the bus and transmitting either command 
mode or data mode information. 




variable 




A method of programming which require an initial design process to 
lay out the program structure in a modular form. Structured 
programming minimizes ‘spaghetti code’ programs by keeping GOTO 
statements to a minimum and by using subroutines to structure the 
program into discrete, easily readable modules. 



subroutine 

A section of a program that performs a specific function on request of 
the main program or another subroutine. Subroutines are used in 
BASIC via the GOSUB statement. 



synchronous data 

Digital information transmitted in predetermined message block sizes 
with a dock signal to synchronize the receiver. See asynchronous data. 



syntax 

The proper grammar required for an interpreter to recognize and 




A pictorial representation of the grammar required for the execution 
of a program statement. 



system 

Any interconnection of instruments or other devices that cooperate to 
accomplish a task. A controller is an essential part of a system 
whenever the designations of talkers and listeners needs to be changed 
during the task. A controller is a necessary part of any system that 
requires data processing or a centralized control point. 

System Device 

The designated file-structured device on the Controller that acts as the 
primary file storage module. The floppy disk or electronic disk may be 
designated as the system device by the File Utility program’s Assign 
option. The floppy disk drive (MFO:) is the default system device. 




storage, file structured 



system memory 

Those portions of the Random Access Memory allocated for use by the 
operating system and utilities or BASIC Interpreter. 



item software 

The collection of programs used to handle file management procedures 
on a system. 



Talker 

An IEEE-488 connected instrument that has been designated by the 
controller on the bus to send data to listeners. 



Time and Date Utility Program 

The program that sets the time and date of the Controller’s real time 
clock. Supplied on the System Disk with the filename TIME.FD2, this 
program accepts the time and date by keyboard inputs, and transmits 
the information to the real-time clock. With battery back-up, the clock 
maintains the correct time and takes into account leap years. The clock 
can be used to time and date stamp programs or data collected by 
programs, or to perform an operation at a specified time. 
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Touch-Sensitive Display 

The combination of the display screen and the touch-sensitive panel 
which acts as the operator’s keyboard. 



warm start 

The activities the Controller performs when the RESTART switch is 
pressed: ceases the current operation and returns to the shell. See cold 
start. 



Universal command 

A message sent across the data lines of a bus that affects all connected 
instruments whether or not they are designated as listeners. 



user memory 

Area reserved in main memory for storage and execution of user- 
written application programs and data. 



A representation of a quantity, or the quantity itself, which can assume 
any of a given set of values. A variable may be integer, string, or 
floating point value designators. 



virtual array 

A matrix stored on a file-structured storage medium as a random 
access file. Virtual arrays can be integer, string, or floating-point arrays 
with one or two dimensions. Once a virtual array file has been opened 
and the virtual array has been dimensioned, the array elements are 
handled by the programmer exactly as they are in main memory array. 



yank buffer 

A temporary memory location where the System Editor program can 

store data “yanked” from a file. 




This appendix describes the relationships among data in the Character 
EPROM (U32), ASCII codes received as input, and the images 
displayed on the 1722A screen. This information and an EPROM 
programmer allow you to create custom character sets for your 1 722A. 

Character cell dot patterns are stored in a 2732A type EPROM. The 
standard character set capacity is 128 characters. The alternate 
character set capability provides an additional 128 characters for a 
total of 256 characters. Each character uses 16 of the PROM’s 
locations (0 though F). In both the standard and the alternate 
character set modes, 115 characters can be displayed directly. Eleven of 
the remaining characters are displayed through the Character 
Graphics Mode. 

Depending on the revision level of the Video-Graphics-Keyboard 
module, the character sets may be identical, or the alternate font may 
contain a selection of symbols and non-English characters. Each 
character is contained in a cell 8 dots wide by 14 dots high. Since every 
dot in each character cell can be displayed, all character codes are 
available for graphics. 

CAUTION 

Leave character position 32 (decimal) blank. ASCII character 
32 is the space character. Erase operations write this character 
on the screen, so position 32 must be left blank. 




Custom Character Sets 



The rules by which standard ASCII display characters are defined 
follow. This information is provided for reference as you design any 
characters you wish. 

o Standard ASCII characters are 9 dots high and up to 7 dots wide. 

□ The topmost row is left blank to provide the spacing between the 
lines. 

□ The leftmost column is left blank for spacing between characters. 

□ Row D is reserved for underlines. 

Upper-case characters, numerals, and symbols like the percent and 
dollar signs, brackets and braces, conform to these rules: 

1. They start on row 1. 

2. They extend to row 9. 

o Lower-case letters with ascenders (like the letter ‘h’) start at row 2. 

□ Lower-case letters with descenders (like ‘g’) extend down to row D. 

□ Other characters (like ‘a’ or the symbol ‘@’) start on row 4. 

Sixteen bytes are reserved in the EPROM for each character cell. The 
first byte corresponds to the top row of dots in the cell. The fourteenth 
byte corresponds to the bottom row. The last two bytes are not used, 
because the hardware does not address these locations. 

The hexadecimal EPROM address of each byte is its ASCII code in 
hexadecimal followed by its byte number within the cell. For example, 
412 is the EPROM address of the third row of ASCII character 
number 41 (A). A 1-bit corresponds to a displayed dot. 
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XAiyiPLE 

This example shows how the capital letter H (ASCII 48) is encoded. 



ADDRESS 1722A DISPLAY 

IN ROM 





E 


4 


2 


3 


|8 


4 2 


3 


480 




• 


• 




• 


• 9 


• 


481 




1 


• 




9 


• • 


1 


482 




1 


: • 




« 


• 9 


II 


483 


• 


ill 


; • 




0 


# • 


1 


484 


• 


1 


: • 




9 


• • 


11 


485 


• 


1 


ii 


iiill 


1 1 : 


1 


486 


• 


ii 


• 


• 


• 


• 9 


1 


487 




w 


• 




« 


9 9 


Wf: 


488 




M 


. • 


• 


• 


9 9 


li 


489 




M 


• 




• 


9 9 


1 


48A 


e 


e 


• 




• 


9 9 


9 



48C 




00 

41 

41 

41 

41 

7F 

41 



41 

00 

00 

00 

00 

00 

00 



E-3 




Custom Character Sets 



THINGS TO KBBP IN MIND 

Before starting, program the first 128 locations in the new EPROM 
with the standard Character set. Set aside the EPROM that is 
presently in the Controller. Now program the new character set 
into the last 128 locations of the copy. Taking these measures will 
ensure that if an error is made, you will still be able to use the 
original EPROM in the I722A. Not only is the display needed in 
order to perform diagnostics, but the original EPROM must be in 
place if you ever need to send the module in for exchange. 

Thirteen character codes in each character set are interpreted as 
control codes. Eleven of the characters in these locations can be 
displayed in the Character Graphics Mode. To select this mode, 
send the sequence ESC [2p. 

In the Character Graphics Mode, character patterns are selected 
for display from the EPROM start addresses listed in the table 
below. 



CHARACTER 




MODE 



CHARACTER 

RECEIVED 


EPROM PATTERN START ADDRESS (HEXADECIMAL) 




STANDARD 


ALTERNATE 


0 


000 


800 


1 


070 


870 


2 


080 


880 


3 


090 


890 


4 


OAO 


8A0 


5 


OBO 


8B0 


6 


OCO 


SCO 


7 


ODO 


8D0 


8 


OEO 


8E0 


9 


OFO 


8F0 




110 


910 



NOTE 

The alternate character set contains the double-size graphics 
characters, so it is necessary to send the escape sequence for 
double size when addressing these locations. 
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Once the PROM has been programmed, use this procedure to install it: 



1 . Set the 1 722A Power switch to OFF and disconnect line power. 

2. Remove the card cage cover (Phillips head screws) and slide 
out the Display Module from slot number 2. 

3. Use a proper IC removal tool to remove the standard character 
set EPROM (U32). 



NOTE 

Save the standard EPROM. If the 1 722 A should need repair, it 
must have the standard character set EPROM installed. The 
Fluke Service Center will need it for proper diagnostic 
displays. If you return a 1722 A for repair without a standard 
character set EPROM, you’ll probably be charged for a new 
one. 

4. Use an IC installation tool to install the custom character set 
EPROM. 

5. Reinstall the Display Module and the rear cover. 

6. Connect line power and turn on the power. 

7. Test the new PROM by using the sample BASIC language 
program on the next page to display both character sets. The 
program works by displaying the primary character set when 
you command “RUN”, and the second when you touch the 
screen. Both fonts are displayed in double-size to let you see the 
characters more clearly, and the program toggles between the 
two character sets for comparison. 



Custom Character Sets 



10 ON CTRL/C GOTO 200 
20 E« » CHR»(27> + "I" \ BL«- 
30 PRINT E« + 

40 PRINT CHR«(iS)j \ IF FL% » 1 THEN 70 ^ 

SO PRINT CP08 <1.0>) "Staniard - Touch Scr»*n for Alt»Tn»te" 

60 GOTO 80 

70 PRINT CPOS "Alttrnat#- Touch Screen for Standard" \ PRINT CHR«<14)» 

80 PRINT CPOS t2. 4)> 

90 FOR 1% - 1 TO 6 \ PRINT CHR*<IX)J \ NEXT IX 
100 FOR IX - 7 TO 10 \ PRINT BL«J \ NEXT IX, 



110 FOR IX » 16 TO 26 \ 

120 FDR IX » 28 TO 31 \ 

130 PRINT CPOS (4, 4)J \ 

140 PRINT CPOS (6. 4>» \ 

ISO PRINT CPOS (8. 4)J \ 

160 WAIT FOR KEY \ ON KEY GOTO 170 
170 KX « KEY \ FLX « -FLX + 1 
180 GOTO 40 

200 PRINT CHR»(27) + "Ep" \ PRINT CHR*(1S) \ END 



PRINT CHR*< IX) » \ NEXT IX \ PRINT BLSj 

FDr'^Ix'^S^32^To'63 ^PRINT CHR*<IX>» \ NEXT IX 
FOR IX - 64 TO 9S \ PRINT CHR*<IX)J \ NEXT IX 
FOR IX ■ 96 TO 127 \ PRINT CHR«(IX)J \ NEXT IX 
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This page can be photocopied for aiding in the design of custom 
character sets. 



Address 

_ 0 

„ ™ 1 
_ - 2 
_ _ 3 
_ _ 4 
_ _ 5 
_ _ 6 
_ 7 

„ _ 8 
_ _ 9 




_ _ 0 




3 

4 



_ _ 5 

» » 6 

_ _ 7 

_ _ 8 

- _ 9 

_ _ A 

_ _ B 

» „ C 

_ _ D 

E 
F 







m O O 03 > 







0 0 0 1 

0 0 10 

0 0 11 

0 10 0 

0 10 1 

0 110 

0 111 

10 0 0 

10 0 1 

10 10 

10 11 

110 0 

110 1 

1110 

1111 

23 2® 2' 2° 



SOM OTL DCl 

2 2 !2 



DC2 

"3” Ti 



I DCS 

i I 20 iT 



EOT SDC DC4 
1 I T 21 15 



ENO PPC NAK PPU 



SYN 

7 ! 23 i? 



ETS 

24 le 



BS GET CAN SPE 
“9 9125 T9 



HT TCT I EM 

To A I 26 iX 



SUB 

27 IB 



ESC 

C I 26 ! ic 



_PS 

D 29 10 



14 E 30 2E 

50 s 

so PS 

18 F 31 IF 

51 Pa 

SI Lhi 

ADDRESSED UNIVERSAL 
COMMANDS COMMANDS 





0 




“1 

1 




NUMBERS 




SYMBOLS 


32 


20 

SP 


46 


30 

0 


I SPACE MLAO 


0 


MLA16 


33 


21 

1 


49 


31 

1 


! 


MLA 1 


1 


MLA17 


34 


22 

rr 


50 


32 

2 


■■ 


MLA2 




MLAie 


35 


23 

# 


51 


33 

3 


S 


MI.A3 


3 


MLA19 


36 


24 


52 


34 

4 


$ 


MLA4 


4 


MLA2C 


37 


26 

% 


53 


36 

5 


% 


MLA5 


5 


MLA21 


38 


26 

& 


64 


36 

6 


i 


MLA6 




MLA22 


39 


27 


55 


37 

7 




ULA7 


7 


MLA23 


40 


28 

{ 


66 


38 

8 


f 


MLA8 




MLA24 


41 


29 

\ 


57 


39 


) 


/ 

MUA9 


9 


MLA25 


42 


2A 

ir 


58 


3A 




MIAIO 




MLA26 


43 


28 

4 - 


59 


3B 

! 




MLA11 




MLA27 


44 


2C 


60 


3C 

< 




MLA12 


< 


MLA28 


49 


20 


61 


30 




MLA13 


_ 


MLA29 


46 


2E 


62 


3E 

> 




ULA14 


> 


MLA30 


47 


2F 

/ 


83 


3F 

? 




MLA19 




UNL 



LISTEN 

ADDRESSES 



MTAO P MTA16 

4T~ 81 51 



MTA1 Q MTA17 
42 82 52 



MTA2 R MTAie 
43 83 53 



MTA3 S MTA19 
JT 84 64 



MTA4 T MTA20 
45 " "86 55 " 



MTA5 U MTA21 
46 ^ 88 56 



MTA6 I V MTA22 
47 I 87 57 



MTA7 W MTA23 
48 88 58 



UTA8 I X MTA24 



MTA9 Y MTA26 
4A" "so 5A 

J z 

MTA10 Z MTA26 
4B 91 50 

K E 

MTA11 I MTA27 
4C 92 5C 

L \ 

MTA12 1 MTA28 
4D 93 5D 

M ] 

MTA 13 1 MTA29 
4E 94 5E 

N A 

MTA14 A MTA30 
4F IS IF 

0 - 

MTA18 - UNT 
TALK 

ADDRESSES 



“ 


1 

0 




“«7 

28 

1 2® 


LOWEI 


R CASE 


98 


60 


112 


70 




USAO 


p 


< 


97 


81 


113 


71 




a 

MSA1 




q 

MSA17 


98 


62 

b 


114 


72 

r 


b 


MSA 2 


r 


MSAI8 


99 


83 


116 


73 




c 




s 


c 


MSA3 


s 


MSA19 


100 


64 

d 


116 


74 

t 


d 


WSA4 




MSA20 


101 


66 

e 


117 


75 

u 


e 


MSA5 


u 


MSA21 


102 


66 

f 


116 


76 

V 


» 


USA6 


V 


MSA22 


TflJ 


67 


119 


77 




g 

MSA7 


w 


w 

MSA23 


104 


66 

h 


120 


73 

X 


h 


MSA8 


X 


MSA24 


106 


69 


121 


79 




i 

MSA9 




y 

MSA25 


108 


6A 


122 


7A 




j 




z 


i 


MSA10 


7 


MSA26 




k 




{ " 


k 


MSA11 


( 


MSA27 


108 


6C 

1 


124 


7C 

1 

1 


1 


MSA12 


* 


MSA2a 


109 


6D 


126 


7D 




m 




) 


m 


USA13 


) 


MSA29 


110 




128 


7g 




n 




ft 


MSAU 


■V 


USA30 


ni 


6F 

0 


127 


m " 


u 


USA16 


RUBOUT 



SECONDARY ADDRESSES 
OR COMMANDS 



hex 

1722A DISPLAY 
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This appendix covers the operation of the System Diagnostic software 
and assists the user in diagnosing problems with the 1722A Instrument 
Controller. 

The System Diagnostic software is provided on a floppy disk and is 
designed to be a customer, manufacturing, and field service tool. 
Successful completion of testing the 1722A using the System 
Diagnostic software gives the user confidence that the I722A 
Instrument Controller is operating properly. 



TENANCE PHILOSOPHY 

The maintenance philosophy for field-service repair is at the module 
level, including the SBC, VGK, video electronics, power supply, floppy 
disk drive, and the options. Faulty modules are identified by using the 
System Diagnostic software. 



Replacement modules are available through your local Fluke Service 
Center. Contact your local Fluke Service Center for details on in- 
warranty repair, and contact the Module Exchange Center for out-of- 
warranty repair. 



The System Diagnostic software uses a menu system and presents the 
I722A as a set of modules. A module is either a circuit board, an 
externally connected peripheral, or a major subsystem. There is a set of 
subtests for each module. Each subtest covers one specific function of a 
module. The test selections are presented on the 1 722A display and use 
touch-sensitive command blocks for making choices. 

The menu system allows individual modules to be selected and tested. 
A particular combination of tests is called a test configuration. The 
Standard Test Configuration can be used to test a standard 1 722A with 
no options installed. Other test configurations can be created, edited, 
stored, and recalled as Configurations A, B, and C. 



Some module tests can cover up to five units (modules of the same 
type). For example, the test for the 5I2K byte Memory Expansion 
module (Option -007) can test from one to five modules. 
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MENU LEVELS 

The diagnostic software has three menu levels: 

□ The Main Menu presents the test configurations, test modes, and a 
destination for the test results. 

□ The Test Menu presents the modules and options that can be 
selected for testing. 

□ The Subtest Menu presents the subtests that can be selected for 
each module and option. 

Here is the menu level diagram: 



1722A SYSTEM DIAGNOSTIC 
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Copy any programs stored in the 1722 A E-Disk onto a floppy 
disk before loading the System Diagnostic software. When the 
System Diagnostic software is loaded into the 1 722 A memory, 
portions of the E-Disk and program memory in the 1722A are 
erased. 



Use the following procedure to run the System Diagnostic software. 



I . Insert the System Diagnostic disk into the disk drive. Power up 
the 1722A, or press the RESTART and ABORT switches on 
the front panel simultaneously if the 1 722A is already running. 




2. After the System Diagnostic software is loaded from the floppy 
disk, the 1722A display reads: 




3. Touch the START TEST command block on the display to 
execute the Standard Test Configuration, or select individual 
tests as described in the following paragraphs. 

4. The test will stop and display a prompt at any point where a 
user response is required. At the end of the test, the results will 
be displayed on the screen. 

NOTE 

If any problems are encountered while loading the System 
Diagnostic software or during the execution of a test, refer to 
“Troubleshooting” at the end of this appendix. 
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Main Menu 

The Main Menu has 1 1 command blocks, described below. 

1. Standard Test Config. 

The Standard Test Configuration is a set of tests that has been 
preselected to test the proper functioning of standard 1 722 A 
system modules. The tests allow untrained personnel to 
perform diagnostic testing. Additional hardware or test cables 
are not used with this test configuration. If the 1722A passes 
the Standard Test Configuration, the I722A is fully functional 
up to the I/O drivers. The I/O drivers are tested with 
additional subtests and external hardware. 

2. Test Config. A, or B, or C 

The purpose of Test Configurations A, or B, or C is to allow the 
creation of special test configurations. To create a 
configuration, select any combination of module tests and 
subtests, and store the special configuration if it will be needed 
again. Instructions on storing special configurations are given 
in the descriptions of the Test Menu selections. 



By pressing the Test Menu command block, the Test Menu is 
displayed. From this menu, alternate test configurations can be 
defined and stored by the user. 

4. Write Last Test Report to Display, or Disk, or Serial Pt. 
(Port). 

After a test has stopped running, these command blocks allow 
the user to redisplay the test results or send them to a floppy 
disk or printer for future use. 

If Write Last Report to Disk is selected, the test results are 
stored in the file MFO:REPORT.DAT. If Write Last Report to 
Serial Pt. is selected, the test results are sent to serial port KB I : 
and can be output to a printer for a hard copy. The default 
baud rate set by the start-up command file when the System 
Diagnostic software is loaded is 1200 baud. Set your printer to 
this baud rate. See Section 5 of the I722A System Guide for 
more information about RS-232 communications and using 
the SET Utility Program. 
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5. Loop Mode 

The LOOP MODE command block performs like a toggle 
switch. When it is off (the power-up default), the test 
configuration executes one time and then stops. When LOOP 
MODE is on, the test configuration continues until the 
ABORT switch on the 1722A front panel is pressed. 

6. Stop On Fail 

The STOP ON FAIL command block performs like a toggle 
switch. When the System Diagnostic software is first loaded, 
STOP ON FAIL is off. When STOP ON FAIL is off, the 
System Diagnostic software tests do not stop if a failure occurs. 

When STOP ON FAIL is selected, the System Diagnostic 
software will halt the test and give a Stop Test Menu whenever 
a failure is encountered. Here is an example of a Stop Test 
Menu: 



n 
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7. Start Test 

The START TEST command block begins execution of the 
currently selected test configuration. The tests are executed 
and any failures are logged. 

To begin any of the test configurations, press START TEST 
on the 1722A display. As the test runs, the 1722A display is 
updated at the completion of each subtest. To return to the 
Main Menu, or to halt any test, press the ABORT switch on the 
1722A front panel. If all the tests in the chosen configuration 
are successful, the display reads ‘No failures’. If any of the tests 
in the selected configuration are unsuccessful, three things 
happen: 

a. The 1722 A display indicates the name of the test in 
progress at the time of the failure. 

b. The errors are stored on the E-Disk. 

c. A Stop Test Menu is displayed with an error log and more 
operator choices. 

CAUTION 



Portions of the System Diagnostic software can write over 
areas of RAM used by FDOS. Always reload the operating 
system by executing a cold start (press the RESTART and 
ABORT buttons on the front panel simultaneously) If 
CTRL /P is used to stop the System Diagnostic software. 
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TEST MENU 

The Test Menu lets the user specify which modules are to be included in 
a particular test configuration. An example of a test configuration is 
the Standard Test Configuration which includes tests for the SBC, 
VGK, and floppy disk drive. If optional modules are installed in the 
1722A, they can also be selected for testing from this menu. 

The Test Menu is displayed on two screens. The first screen has 15 
possible module selection blocks and six additional command blocks. 
The module selection blocks act as toggle switches to select and 
deselect the module. 

The Test Menu includes module selection blocks for the SBC, Floppy 
Disk Drive, VGK, Option -006 256K RAM, Option -007 5I2K RAM, 
and Option -008 IEEE-488/ RS-232. Here is an example of the first 
screen of the Test Menu: 



V— 



Test Menu 



—1 




HB 


Parallel 

Interface 

-002 


Bubble 

MemoTu 

-004/9 


256K RAM 


512K RAM 
Option 
-007 


IEEE/RS232 


Dual 

Serial I/i 
-009 


Dual Disk 
Drive 
1760/61A 


Winchetter 

Disk 

1765A/AB 










ALL OFF 


STORE 

CONFIG. 

A 


STORE 

CONFIG. 

B 


STORE 

CONFIG. 

C 


MAIN 

MENU 


START TEST 
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When a module is selected from the Test Menu the second screen is 
displayed. The lower six command blocks in the Test Menu are 
replaced with another set of command blocks. If the desired module is 
already selected, it must be toggled off and on again to display the 
second screen. 

From the second screen of the Test Menu, the user can choose how 
many of the selected modules are to be tested, return to the first screen 
of the Test Menu, or go to the Subtest Menu for the selected module. 
Here is an example of the second screen of the Test Menu: 
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The command blocks for both screens of the Test Menu are described 
in the following paragraphs. 

1. All Off 

The All Off command block deselects all the modules in the 
Test Menu that were previously selected for testing. 

2. Store Configuration A, or B, or C 

After a test configuration has been selected by lighting the 
appropriate display blocks in the Test Menu and subtest 
Menus, the test configuration may be stored as Test 
Configuration A, B, or C by touching one of these command 
blocks. The special configuration is stored on the floppy disk 
and can be used again by selecting it from the Main Menu. 

3. Unit# 1, 2, 3, 4, 5 

From the second screen of the Test Menu the user can select the 
number of units (modules of the same type) to be included in 
the testing. 

4. Normal Buttons 

When the Normal Buttons command block is selected, the 
System Diagnostic software returns to the first screen of the 
Test Menu. 

5. Main Menu 

When the Main Menu command block is selected, the System 
Diagnostic software returns to the Main Menu. 

6. Start Test 

When the Start Test command block is touched, the currently 
selected test configuration begins to execute. 

7. Subtest Menu 

When the Subtest Menu command block is selected, the 
Subtest Menu for the chosen module is displayed. 
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SUBTEST MENUS 

There is a Subtest Menu for each module listed in the Test Menu. From 
the Subtest Menu the user can select specific tests to be executed for the 
chosen module. This is useful for obtaining more specific information 
about a module that has failed. For example, a failure at an RS-232 
port may be due to a problem on either side of the I/O buffers. To 
isolate the problem, there is an Internal Loopback Test, an External 
Loopback Test, and a Port-to-Port Loopback Test, any of which can 
be selected to exercise a particular portion of the module circuitry. 

For each module subtest, there are 15 toggle type subtest selection 
blocks and five command blocks. An example of the SBC Subtest 
Menu is shown below. 




8in 


le Board Computer 




mom 








Osstructivs 
Hscrof tore 
(exit 8D> 


Destroctive 
RAH (exit 
SD) 




RS23S 

External 

Loop 


RB232 Port 
to Port 
Loop 




IEEE Port 
to Port 
Loop 








ftLL 


SELECT 

STANDARD 

SUBTESTS 


HAIN MENU 


TEST MENU 


START TEST 



V 






The command blocks in the Subtest Menu operate identically to the 
command blocks described above for the Test Menu. The subtest 
selection blocks for each of the modules are described in the following 
paragraphs. 



NOTE 

The subtest selection blocks labelled "exit SD” are stand-alone 
programs that are loaded into memory, deleting the System 
Diagnostic software in the process. They cannot be run in 
LOOP MODE, because they do not return to SD after the test 
is completed. To reload the System Diagnostic software, press 
the RESTART and ABORT buttons simultaneously. 
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Subtest Descriptions 

SBC (Single Board Computer) 

The SBC Subtest Menu includes the following tests: 

1. Clock 

Checks time rollover and storage of all stages of the real-time 
clock registers. 

2. ROM Checksum 

Generates a checksum for the contents of the BOOT ROM. 
The test fails if the checksum is not equal to zero. 

NOTE 

The ROM checksum test will not work properly with Version 
TO of the BOOT ROM. The correct checksum for Version 1.0 
is hex 8AA0. 

3. Non-Destructive Macrostore 

Performs a read/ write test of Macrostore memory. The 
contents of Macrostore are left intact at the end of the test. 

4. Non-Destructive RAM 

This tests portions of SBC memory not currently used by the 
System Diagnostic software. The test checks for stuck data 
bits, addressing errors, refresh errors, parity errors, and 
timeout errors. 

5. Address Bus Test 

This test uses the same algorithm as the Non-Destructive RAM 
test, but covers all of physical memory, on the SBC and on any 
RAM options that are installed in the 1722A. Timeout errors 
are not reported, so if a RAM option fails to respond (missing 
or faulty) it will not be tested. When known good RAM 
options are installed in the 1722A, this test will check out the 
address and data buffers on the SBC. 
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6. Destructive Macrostore 

This is a comprehensive memory test including pattern 
sensitivity. The System Diagnostic software loads another 
program from the disk to do this test, deleting the Operating 
System and the System Diagnostic software from the 1722A 
memory in the process. This test takes several minutes to 
complete. At the conclusion of the test, the Operating System 
and the System Diagnostic software must be reloaded. 

7. Destructive RAM 

This is an intensive memory test requiring approximately 30 
minutes to execute. When the test is over, the System 
Diagnostic software must be reloaded because the test deletes 
the software from memory. 

8. RS-232 Internal Loop 

This test sets an internal loopback mode on the UART 
(Universal Asynchronous Receiver Transmitter) to allow the 
1722A to send and receive data internally. The I/O buffers to 
off-board devices are not tested. 

9. RS-232 External Loop 

This test uses a special test connector (Fluke P/N 732107) to 
allow any port to talk to itself. This tests the buffers and 
registers of the RS-232 port. 

10. RS-232 Port-to-Port Loop 

A Null Modem cable (Fluke Model Number Y 1705) is required 

to permit two RS-232 ports to communicate with each other 
and test the entire communications interface including the 
buffers. The Option 17XXA-008 IEEE/RS-232 Interface 
module must be installed to run this test. The Null Modem 
cable connects the RS-232 ports on the SBC and the Option - 
008 module. 
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11. IEEE Internal Loop 

The IEEE-488 Internal Loop tests the operation of the IEEE- 
488 interface. The buffers to the IEEE-488 bus are not tested. 

12. IEEE Port to Port Loop 

The IEEE-488 Port-to-Port Loop Test verifies the port’s 
ability to transmit or receive data and drive the IEEE-488 bus. 
Use any standard Fluke IEEE488 cable, Y8021, Y8022, or 
Y8023, The Option 17XXA-008 IEEE/RS-232 module must 
be installed to run this test. The IEEE cable connects the IEEE- 
488 ports on the SBC and the Option -008 module. Switch 
positions 5 and 6 on the SBC must be in the “OFF” position 
and switch positions 5 and 6 on the Option -008 module must 
be in the “ON” position for the test to complete successfully. 

NOTE 

This test requires the user to remove the SBC or Option -008 
module from the 1 722 A chassis in order to verify proper switch 
settings. It is not necessary to run this test unless there are 
IEEE-488 bus problems that cannot be identified using the 
Standard Test Configuration supplied with the System 
Diagnostic software. If it becomes necessary to run this test, 
refer to the discussion on “Installing Hardware Options" in the 
section entitled “Options" in the 1722 A System Guide. This 
discussion explains how to remove the rear panel to gain access 
to the SBC and Option -008 module. A Iso, be sure to return the 
SBC and -008 option to their initial switch configuration after 
running the test. 




G-13 




System Diagnostic Software 



Floppy Disk Drive 

The Floppy Disk Drive menu includes the following tests: 

1, Write Protect Switch 

This test displays the status of the Write Protect Switch. 
Removing or inserting a disk causes the switch to toggle. The 
System Diagnostic software tests to insure that the switch does 
toggle. When testing is complete, touch the screen, and the 
System Diagnostic software reports its findings. 

2. Track 0 Sw & Stepper Motor 

A disk is not needed for this test. The read / write head is moved 
from track 00 to track 39 and back again to test the operation 
of the track 00 indicator and the stepper motor. 



A disk must be loaded to perform this subtest. Any disk will do, 
because nothing is written or read from the disk. 

In this subtest the disk speed is measured and tested to insure it 
is within tolerance. The disk speed is displayed continuously if 
the System Diagnostic software is not in the LOOP MODE. 
When the System Diagnostic software is in the LOOP MODE, 
the disk speed is sampled and displayed for about 15 seconds, 
then the test continues to the next subtest. If the test results 
indicate that the disk speed needs to be adjusted, please refer to 
the 1722A Service Manual or return the unit to your local 
Fluke Service Center for servicing. 

4. Bad Block Scan 

Each block on the disk is read and checked for errors. A total of 
1600 blocks is read (two passes over the disk). The disk is never 
written on. Use this subtest to check a disk for bad blocks. If 
this subtest is used to check the disk drive itself, a disk with 
flawless format is required. 




System Diagnostic Software 



5. Soft Error Rate 

This subtest does an extensive test of the disk drive’s ability to 
read a worst case data pattern over many passes of the disk. A 
scratch disk with error free format is required. After writing the 
worst case data pattern (hex 6DB6DB...) over the entire disk 
surface, the disk is read for 306 passes (over 1 billion bits). This 
test takes approximately 3 hours to complete. 

The display indicates the progress of the subtest while the disk 
is being read, showing the disk pass number, blocks read, bits 
read, and the current number of soft and hard errors. Refer to 
“Troubleshooting” at the end of this section for a description of 
soft and hard errors. 

If the System Diagnostic software is in LOOP MODE, the 
total number of disk passes, blocks read, etc., for all the times 
the subtest was executed, are also shown in the display. The 
display is updated at the end of each disk pass. 

6. Random block I/O 

This subtest tests the floppy disk drive’s worst case ability to 
read, write, and seek. It is identical to the Soft Error Rate test 
except that the block number is chosen at random. A seek to 
the chosen block is followed by writing the worst case data 
pattern and reading it back. The total number of blocks tested 
is 800. The soft and hard errors are handled the same as iri the 
Soft Error Rate Test. 

7. Format Disk 

Formats a floppy disk in standard 1722A (double-sided) 
format. The operator will be asked for confirmation before 
proceeding. 
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VGK (Video/Graphics/Keyboard Interface) 

The VGK menu includes the following subtests; 

1. Alignment pattern 

Displays the alignment pattern used for the initial factory setup 
of the CRT and permits later checking for shift of the display. 

2. Keyboard 

A picture of the keyboard is displayed on the screen. Each time 
a key is pressed on the 1722A keyboard, the corresponding key 
on the display toggles either on or off. Follow the instructions 
to light all the keys on the display and then touch the screen to 
continue. The diagnostic software records an error if a 
keystroke was not detected. 

3. Touch-Sensitive Overlay 

The Touch-Sensitive Overlay (TSO) grid is displayed. Each 
square covers exactly one TSO touch pad. Light each square 
by touching it. Press each one again to turn it off. The subtest 
passes if each touch pad responds at least twice. If a square 
does not work, exit the subtest by pressing the ABORT switch 
on the 1722A front panel. 

NOTE 

The following suhtests will not work with versions of the VGK 
Firmware prior to 1.4. 

4. Graphics RAM 

Performs a read/ write test of graphics memory and checks for 
stuck data bits and addressing errors. The display will be filled 
with a test pattern during this test. 

5. Vector Generator 

Performs a comprehensive test of the vector generator by 
drawing a series of vectors on the screen and reading back the 
contents of graphics memory. 
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6. Character and Attribute RAM 

Performs a read /write test of character and attribute memory 
and checks for stuck data bits and addressing errors. The 
display will be filled with a test pattern during this test. 



Parallel Interface Option -002 

PIBTST is a program that tests up to three Parallel Interface Modules 
(Option 17XXA-002). The program performs three separate tests 
including writing to a port and reading back from the same port 
(Read back), writing to one port and reading back on the other port 
(Loopback), and an Interrupt test. When the program runs, the 
numbers of the modules under test are displayed across the top of the 
screen and the tests that are executing are displayed down the left side 
of the screen. In order to pass the Loopback test, a special test cable 
(JF/PN 632968) must be connected between the two ports on the 
module. If the user does not have a test connector, the Readback and 
Interrupt tests may be run individually by touching the PASS/FAIL 
block on the screen at the bottom of the column corresponding to the 
module under test. At this point a second menu is displayed. The user 
may run the tests individually on either port of the selected module by 
touching the screen at the appropriate point. 

Bubble Memory Options -004 and -005 

MBXTST is a program for testing up to three Bubble Memory 
Modules (Options I7XXA-004 and 17XXA-005). The program writes 
test patterns to the Bubble Memory to check for bubble collapse errors 
(a “1” bit turning into a “0”) and pattern sensitivity problems with the 
Formatter/ Sense Amplifier (FSA). Before executing the test, the 
program checks to see if there are any files on the bubble devices MBO: 
through MB3: and the user is asked to confirm whether he wants the 
files deleted. The bubble devices must be formatted in order for the test 
to execute properly. The bubble memories were formatted at the 
factory and should not need to be reformatted unless there is a problem 
with the module. Any errors found during the test will be displayed on 
the screen and summarized at the end of the test. If the test will not 
execute properly try formatting the bubble memory using the File 
Utility Program (refer to Section 4 of the System Guide). 
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256K RAM Option -006 

Up to five units can be tested at once by selecting the unit numbers 
from the Test Menu. Each unit number corresponds to a specific 
switch setting as described in the information supplied with the option 
or in the section of the 1722A System Guide entitled ‘Options’. 

The menu for the 256K RAM option includes the following tests; 

1. Non-Destructive RAM Test 

This subtest operates the same as the SBC Non-destructive 
RAM test. 

2. Destructive RAM Test 

This subtest operates the same as the SBC Destructive RAM 
test. The test may take several hours to complete depending on 
how many Option -006 modules are installed. 



512K RAM Option -007 

Up to five units can be tested at once by selecting the unit numbers 
from the Test Menu. Each unit number corresponds to a specific 
switch setting as described in the information supplied with the option 
or in the section of the 1722A System Guide entitled ‘Options’. 

The menu for the 5I2K RAM includes the following tests: 

1. Non-Destructive RAM Test 

This subtest operates the same as the SBC Non-destructive 
RAM test. 

2. Destructive RAM Test 

This subtest operates the same as the SBC Destructive RAM 
test. The test may take several hours to compete depending on 
how many Option -007 modules are installed. 
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The subtest for the IEEE-488/RS-232C option operates the same as 
SBC Loop Tests. The cables described in the section on SBC subtests 
are also used for the IEEE and RS-232 port tests for the -008 option. 
For the IEEE Port-to-Port test, however, switch position 5 and 6 on 
the SBC are set to the “ON” position and switch positions 5 and 6 on 
the Option -008 module are set to the “OFF” position. Here is a list of 
the subtests for Option -008. 

1. RS-232 Internal Loop 

2. RS-232 External Loop 

3. RS-232 Port~to~Port Loop 

4. IEEE-488 Internal Loop 

5. IEEE-488 Port-to-Port Loop 

NOTE 

This lest requires the user to remove the SBC or Option -008 
module from the 1 722 A chassis in order to verify proper switch 
settings. It is not necessary to run this test unless there are 
IEEE-488 bus problems that cannot be identified using the 
Standard Test Configuration supplied with the System 
Diagnostic software. If it becomes necessary to run this test, 
refer to the discussion on “Installing Hardware Options” in the 
section entitled “Options” in the 1722 A System Guide. This 
discussion explains how to remove the rear panel to gain access 
to the SBC and Option -008 module. Also, be sure to return the 
SBC and -008 option to their initial switch configuration after 
running the test. 

Dual Serial Interface Option -009 

SPTEST performs a port-to-port loopback test between the two ports 
on up to three -009 Options installed in the 1722A. 255 characters are 
transmitted and received on each port. An RS-232 Null Modem cable 
(Fluke Model Y1705) must be connected between the two ports on 
each -009 Option. The port addresses must be set according to the 
information for the -009 Option in Section 9 of the System Guide. 
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MFXTST is a program to test up to two 1760A or 1761 A Disk Drive 
Systems. Refer to the section entitled “Options” in the 1722A System 
Guide or the information supplied with the I760A or 1761A for 
instructions on switch settings and connecting the unit to the 1722A. 
The program will check the disk drive speed and disk detection logic, 
then seek, format, write and readback data from a disk installed in each 
drive. The program will erase any files on the disk. Refer to the 
i760A/1761A Manual for more information. 



1765A/AB Winchester Disk Drives 

WDXTST is a progam for testing the 1765A/AB Winchester Disk 
Drive. The test selections are displayed on the screen and are selected 
by touching the desired menu item. The tests include a self test of the 
1765A/ AB Winchester controller board and a verification of all of the 
blocks on the disk. If a bad block is found on the disk, that block is no 
longer used for storing data and an alternate block is automatically 
assigned. 



TROUBLESHOOTING 

When the System Diagnostic software encounters an error during the 
execution of a test, an entry is made in an error log. If STOP ON FAIL 
has been selected from the Main Menu, an error message is displayed 
on the screen. This message includes the name of the module under test 
and the particular subtest being executed when the error occurred. 

Generally, the module under test is at fault whenever an error occurs. If 
an error is reported, check that the switch settings are correct on the 
module in question (if applicable), then run the test again. If the error 
condition persists, contact your local Fluke Service Center for 
information about replacing the faulty module. A list of replacement 
module part numbers is included at the end of this section. 

If you are experiencing difficulty in getting the System Diagnostic 
software to load and execute properly, the following paragraphs 
provide some general guidelines for diagnosing problems with the 
1722A. 
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When the 1722A is first powered on, the fan on the rear panel starts up, 
and two beeps can be heard; one from the 1 722A chassis and one from 
the keyboard if it is plugged in. If these things do not happen, check to 
see that the line cord is properly installed and that the fuse is intact. 
Also verify that the line voltage indicated on the rear panel matches 
your line power source. If everything is in order, the power supply is 
faulty. 



If the fan is running but there is no beep from the chassis, either the 
VGK or the PUP (power-up) assembly are faulty. 




y Problems 

After the 1722A has been on for at least one minute, messages should 
be visible on the display. If the display is completely blank, except for a 
blinking cursor, try a cold start. Press the RESTART and ABORT 
switches on the 1722A front panel simultaneously. If the problem 
persists, the VGK, CRT, and video electronics are functional and the 
SBC is probably faulty. 



If there is no display at all after a power-up or cold start, but there is a 
beep from the chassis, the VGK is functional, and either the CRT, 
video electronics, or associated cables are faulty. 




After the 1722A has executed the power-up self-test sequence, it 
attempts to load the operating system (FDOS2.SYS) from the floppy 
disk. The message “LOADING” should be displayed on the screen, 
and the disk drive activity light on the front panel should come on. If 
the disk drive activity light does not come on, either the disk drive or 
associated cables are faulty, 

If the disk drive activity light comes on, but the operating system does 
not load, an error message appears on the screen. Refer to Sections 3 
and 4 of the 1722A System Guide for a description of the self-test and 
system error messages. 

A soft error is any single failure to read a block correctly. It can be 
caused by improper seating of the disk or by a dust particle 
momentarily passing under the read /write head. An occasional soft 
error is of no concern. Twenty successive soft errors are considered a 
hard error and indicate a problem either with the disk or the diskdrive. 
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In general, whenever a disk error occurs, the disk should be reseated by 
opening and reclosing the disk drive door. If the problem persists, try 
another disk. If this solves the problem, the original disk was faulty. 

If the problem cannot be solved by using another disk, then the disk 
drive is either faulty or out of calibration. One other possibility is that 
the disk controller on the SBC is out of calibration. In either case, 
calibration should only be performed by authorized service personnel. 
Contact your local Fluke Service Center. 




During a power-up or cold start, the keyboard should emit an audible 
lone, and both the CAPS LOCK and PAGE MODE indicators should 
light momentarily. If this does not occur, the keyboard is faulty. 

After the operating system is loaded, it may be necessary to use the 
keyboard to access some of the diagnostic programs. If the keyboard 
does not respond when a key is pressed, press CTRL /T to reset the 
keyboard and display. If this doesn’t help, unplug the keyboard from 
the front panel and then plug it in again to perform a power-up reset of 
the keyboard. If the problem still persists, the keyboard is faulty. 

Other Problems 

Once the System Diagnostic software is loaded, if there are problems 
with the appearance of the menus, the VGK may be faulty. The 
software makes extensive use of block graphics and video attributes. If 
some of the reverse video blocks or highlighted characters do not 
appear to be correct, replace the VGK. 

If the display does not respond when a menu block is touched, try other 
menu blocks. Keep in mind the possibility of parallax error as 
discussed in Section 2 of the 1722A System Guide. If the problem 
persists, the Touch-Sensitive Display is faulty. 

If you experience other problems with the 1722A that are not discussed 
in this section, call your local Fluke Service Center for further 
assistance. 
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REPLACEMENT PARTS 

This list gives part numbers for all replacement modules in the 1722A 
Instrument Controller, as well as part numbers for the various 
loopback cables and connectors required for the IEEE-488 and RS- 
232 tests. 



DESCRIPTION 


PART NUMBER 


3 A Fuse,(115 Volt operation) 


109199 


2A Fuse, (230 Volt operation) 


109173 


Power Up Assembly (PUP) 


704353 


Power Supply 


718064 


Floppy Disk Drive 


661629 


Single Board Computer (SBC) 


705285 


Video/Graphics/Keyboard Interface (VGK) 


661587 


CRT and Video Electronics 


718056 


Touch-Sensitive Overlay 


661678 


Keyboard 


718106 


PIB Loopback Cable 


632968 


RS-232 Loopback Connector 


732107 


RS-232 Null Modem Cable 


Y1705 


IEEE-488 Cable (shielded) 


Y802I 


1722A Service Manual 


732156 


System Diagnostic Disk 


(reorder 1722A-200U) 



Additionally, a Field Service Kit is available which contains all the 
above modules under Fluke P/N 729343. These kits are intended for 
use by qualified Service Personnel. Using Module Exchange as backup 
support, one kit should be sufficient to support approximately ten 
1722A units. 
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